[MS-OSHARED]: 

Office Common Data Types and Objects Structures 


Intellectual Property Rights Notice for Open Specifications Documentation 

■ Technical Documentation. Microsoft publishes Open Specifications documentation fac. ^ 
protocols, file formats, languages, standards as well as overviews of the interaction among each 
of these technologies. 

■ Copyrights. This documentation is covered by Microsoft copyrights. Regardless of any other 
terms that are contained in the terms of use for the Microsoft website that hosts this 
documentation, you may make copies of it in order to develop implementations of the 
technologies described in the Open Specifications and may distribute portions of it in your 
implementations using these technologies or your documentation as necessary to properly 
document the implementation. You may also distribute in your implementation, with or without 
modification, any schema, IDL's, or code samples that are included in the documentation. This 
permission also applies to any documents that are referenced in the Open Specifications. 

■ No Trade Secrets. Microsoft does not claim any trade secret rights in this documentation. 

■ Patents. Microsoft has patents that may cover your implementations of the technologies 
described in the Open Specifications. Neither this notice nor Microsoft's delivery of the 
documentation grants any licenses under tho se or any other Microsoft patents. However, a given 
Open Specification may be covered by Microsoft Open Specification Promise or the Community 
Promise . If you would prefer a written license, or if the technologies described in the Open 
Specifications are not covered by the Open Specifications Promise or Community Promise, as 
applicable, patent licenses are available by contacting iplq(5)microsoft.com . 

■ Trademarks. The names of companies and products contained in this documentation may be 
covered by trademarks or similar intellectual property rights. This notice does not grant any 
licenses under those rights. 

■ Fictitious Names. The example companies, organizations, products, domain names, e-mail 
addresses, logos, people, places, and events depicted in this documentation are fictitious. No 
association with any real company, organization, product, domain name, email address, logo, 
person, place, or event is Intended or should be inferred. 

Reservation of Rights. All other rights are reserved, and this notice does not grant any rights 
other than specifically described above, whether by implication, estoppel, or otherwise. 

Tools. The Open Specifications do not require the use of Microsoft programming tools or 
programming environments in order for you to develop an implementation. If you have access to 
Microsoft programming tools and environments you are free to take advantage of them. Certain 
Open Specifications are intended for use in conjunction with publicly available standard 
specifications and network programming art, and assumes that the reader either is familiar with the 
aforementioned material or has immediate access to it. 

Preliminary Documentation. This Open Specification provides documentation for past and current 
releases and/or for the pre-release (beta) version of this technology. This Open Specification is final 


1/205 

[MS-OSHARED] - V20120122 
Office Common Data Types and Objects Structures 

Copyright © 2012 Microsoft Corporation. 

Release: Sunday, January 22, 2012 


documentation for past or current releases as specifically noted in the document, as applicable; it is 
preliminary documentation for the pre-release (beta) versions. Microsoft will release final 
documentation in connection with the commercial release of the updated or new version of this 
technology. As the documentation may change between this preliminary version and the final 
version of this technology, there are risks in relying on preliminary documentation. To the extent 
that you incur additional development obligations or any other costs as a result of relying on this 
preliminary documentation, you do so at your own risk. 


Revision Summary 


Date 

Revision 

History 

Revision 

Class 

Comments 

06/27/2008 

1.0 


Initial Availability 

01/16/2009 

1.01 

Editorial 

Revised and edited the technical content 

07/13/2009 

1.02 

Major 

Changes made for template Ijpmpligipr 

08/28/2009 

1.03 

Editorial 

Revised and edited tjj^lgchnical Igfbtent 

11/06/2009 

1.04 

Editorial 

Revised and edited the technical cohitelii'' 

02/19/2010 

2.0 

Editorial 

Revised and edited the technical|p>ntent 

03/31/2010 

2.01 

Editorial 

Revised and edited the technical content 

04/30/2010 

2.02 

Editorial 

Revised and edited the technical content 

06/07/2010 

2.03 

Editorial 

Revised and edited the technical content 

06/29/2010 

2.04 

Editorial 

Changed language and formatting in the technical 
content. 

07/23/2010 

2.04 

No change 

No changes to the meaning, language, or formatting of 
the technical content. 

09/27/2010 

2.04 

No change 

No changes to the meaning, language, or formatting of 
the technical content. 

11/15/2010 

2.04 

No change 

No changes to the meaning, language, or formatting of 
the technical content. 

12/17/2010 

2.04 

No change 

No changes to the meaning, language, or formatting of 
the technical content. 

03/18/2011 

2.04 

No change 

No changes to the meaning, language, or formatting of 
the technical content. 

06/10/2011 

2.04 

No change 

No changes to the meaning, language, or formatting of 
the technical content. 

Jlfco/201^ 

fc- 5 

Minor 

Clarified the meaning of the technical content. 


2/205 

[MS-OSHARED] - V20120122 
Office Common Data Types and Objects Structures 

Copyright © 2012 Microsoft Corporation. 

Release: Sunday, January 22, 2012 




Table of Contents 








1 Introduction 9 

1.1 Glossary 9 

1.2 References 12 

1.2.1 Normative References 12 

1.2.2 Informative References 13 

1.3 Structure Overview (Synopsis) 14 

1.3.1 Toolbar Customization 

1.3.2 Property Set Storage 

1.3.3 RefEdit Control 

1.3.4 Visual Basic for Applications Digital Signature 

1.3.5 Byte Ordering 

1.4 Relationship to Protocols and Other Structures .... 

1.4.1 Toolbar Customization 

1.4.2 Property Set Storage 

1.4.3 Visual Basic for Applications Digital Signature 

1.5 Applicability Statement 

1.5.1 Toolbar Customization xmLL 

1.5.2 Property Set Storage 

1.5.3 Visual Basic for Applications Digital Signature 

1.6 Versioning and Localization 

1.6.1 Toolbar Customization 

1.6.2 Property Set Storage 

1.6.3 

1.7 Vendor- 

1.7.1 Toolbar Customization 

1.7.2 Property Set Storage 20 

1.7.3 Visual Basic for Applications Digital Signature 20 


ML 


riupeiiy oei oiuidye 

Visual Basic for Applications Digital Signature 

:ndor-Extensible Fields 


.. 16 
.. 18 
.. 18 
.. 18 
.. 19 
.. 19 
.. 19 
.. 19 
.. 19 
.. 19 
.. 19 
.. 19 
.. 20 
.. 20 
.. 20 
.. 20 


2 Structures JL 21 

2.1 Common ABNF Definitions 21 

2.2 Data Types 23 

2.2.1 Common Data Types 23 

2.2. 1.1 ObjectUpdateEnum 23 

2.2. 1.2 DataViewAspectEnum 23 

2.2. 1.3 MSONFC 24 

2.2. 1.4 WebScreenSizeEnum 26 

2.2. 1.5 FilePointer 26 

2.2. 1.6 FixedPoint 26 

2.3 Common Objects 27 

2.3.1 Toolbar Customization 27 

2.3A1 TBCBitmap 27 

2.Jf‘‘2 BITMAPINFOHEADER 28 

2.3. 1.3 RGBQuad 29 

2.3. 1.4 WString 29 

2.3. 1.5 SRECT 30 

2.3. 1.6 TB 30 

2.3. 1.7 TBTRFIags 31 

2.3. 1.8 TBFIags 33 

2.3. 1.9 TBVisualData 33 

2.3.1.10 TBCHeader 36 


3/205 


[MS-OSHARED] - V20120122 
Office Common Data Types and Objects Structures 

Copyright © 2012 Microsoft Corporation. 

Release: Sunday, January 22, 2012 



2.3.1.11 TBCFIags 37 

2.3.1.12 TBCSFIags 38 

2.3.1.13 TBCData 41 

2.3. 1. 14 TBCGenerallnfo 42 

2.3.1.15 TBCGIFIags 43 

2.3.1.16 TBCExtralnfo 43 

2.3.1.17 TBCBSpecific 45 

2.3.1.18 TBCBS Flags 46 

2.3.1.19 TBCComboDropdownSpecific 47 

2.3.1.20 TBCCDData £7 

2.3.1.21 TBCMenuSpecific 48 

2.3.2 Visual Basic for Applications Digital Signature Storage 48 

2.3.2. 1 DigSiglnfoSerialized 49 

2. 3. 2.2 DigSigBlob 50 

2. 3. 2.3 WordSigBlob 51 

2. 3. 2. 4 VBA Digital Signature 52 

2. 3. 2. 4.1 SignedData Constraints 52 

2. 3. 2. 4. 2 Signerlnfo Constraints 52 

2. 3. 2. 4. 3 SignedData contentlnfo Structures 53 

2. 3. 2. 4. 3.1 SpcIndirectDataContent 53 

2. 3. 2. 4. 4 Signerlnfo authenticatedAttributes Structures 54 

2. 3. 2. 4. 4.1 SpcStatementType 54 

2. 3. 2.4.4. 2 SpcSpOpusInfo 54 

2. 3. 2.4.4. 3 SpcString 54 

2. 3. 2.4.4. 4 SpcLink 55 

2. 3. 2. 4. 5 Signerlnfo unauthenticatedAttributes 55 

2. 3. 2. 4. 6 VBA Digital Signature Verification 55 

2. 3. 2. 4. 6.1 Certificate Processing 55 

2. 3. 2. 4. 6. 2 Timestamp Processing 56 

2. 3. 2. 5 Serialized Certificate Store Structure 56 

2. 3. 2. 5.1 SerializedCertificateEntry 56 

2. 3. 2. 5. 2 EndElementMarkerEntry 56 

2. 3. 2. 5. 3 SerializedPropertyEntry 57 

2. 3. 2. 5. 4 CertStoreCertificateGroup 58 

2. 3. 2. 5. 5 VBASigSerializedCertStore 58 

2.3.3 Property Storage 59 

2.3.3. 1 Property Types 59 

2. 3. 3. 1.1 PropertySetSystemldentifier 59 

2.3.3. 1.2 VtThumbnailValue 59 

2.3.3. 1.3 VtThumbnail 60 

2.3.3. 1.4 Lpstr 61 

2.3.3. 1.5 Unaligned Lpstr 61 

2.3.3. 1.6 Lpwstr 62 

2^3.3. 1.7 VtVecLpwstrValue 63 

2.3.3. 1.8 VtVecLpwstr 63 

2.3.3. 1.9 VtVecUnalignedLpstrValue 63 

2.3.3.1.10 VtVecUnalignedLpstr 64 

2.3.3.1.11 VtString 64 

2.3.3.1.12 VtUnalignedString 65 

2.3.3.1.13 VtHeadingPair 65 

2.3.3.1.14 VtVecHeadingPairValue 66 

2.3.3.1.15 VtVecHeadingPair 66 

2.3.3.1.16 VtDigSigValue 67 


4/205 


[MS-OSHARED] - V20120122 
Office Common Data Types and Objects Structures 

Copyright © 2012 Microsoft Corporation. 

Release: Sunday, January 22, 2012 



2.3.3.1.17 VtDigSig 

2.3.3.1.18 VtHyperlink 

2.3.3.1.19 VecVtHyperlink 

2.3.3.1.20 VtHyperlinkValue 

2.3.3.1.21 VtHyperlinks 

2. 3. 3. 2 OLE Property Sets 

2. 3. 3. 2.1 Summary Information Property Set 

2. 3. 3. 2. 1.1 PIDSI 

2. 3. 3. 2. 2 Document Summary Information Property Set 

2. 3. 3. 2. 2.1 PIDDSI 

2. 3. 3. 2. 3 User Defined Property Set 

2. 3. 3. 2. 3.1 User Defined Property Set Constraints 

2. 3. 3. 2. 3. 1.1 Required Properties 

2. 3. 3. 2. 3. 1.2 Supported Types 

2. 3. 3. 2. 3. 2 Reserved Properties 

2. 3. 3. 2. 3. 3 Linked Properties 

2.3.4 SmartTag Objects 

2.3.4. 1 PropertyBagStore 

2. 3. 4. 2 FactoidType 

2. 3. 4. 3 PropertyBag 

2. 3. 4. 4 Property 

2. 3. 4. 5 PBString 

2.3.5 RefEdit Control 

2.3.6 Custom XML Data Storage 

2.3.6. 1 Custom XML Data Storage Item 

2. 3. 6. 1.1 Custom Property Editor 

2. 3. 6. 1.1.1 XMLNamespace 

2. 3. 6.1. 1.2 XSNLocation 

2. 3. 6. 1.1. 3 showOnOpen 

2. 3. 6. 1.1. 4 defaultPropertyEditorNamespace 

2. 3. 6. 1.1. 5 custom Property Editor 

2.3.6. 1.1.6 custom PropertyEditors 

2.3.6. 1.2 Custom Xsn 

2. 3. 6.1. 2.1 ST_True False 

2.3.6. 1.2.2 xsnLocation 

2.3.6. 1.2. j^cached 

2.3.6. 1.2.4 openByDefault 

2.3.6. 1.2.5 xsnScope 

2. 3. 6. 1.2. 6 customXsn 

2.3.6. 1.3 Schema for Content Type 

2.3.6. 1.3.1 ContentTypeld 

2. 3. 6.1. 3. 2 IntNonNegative 

2.3.6. 1.3.3 UniqueldentifierWithoutBraces 

$. 3 . 6 . 1.3.4 UniqueldentifierWithoutBracesOrEmpty .... 

2.3.6. 1.3.5 DummyContentTypeElement 

2.3.6. 1.3.6 schema 

2.3.6. 1.3.7 contentTypeSchema 

.3.6. 1.4 Cover Page Properties 

2.3.6. 1.4.1 ST_PublishDate 

2. 3. 6.1.4. 2 PublishDate 

2. 3. 6.1.4. 3 Abstract 

2.3.6. 1.4.4 CompanyAddress 

2.3.6. 1.4.5 CompanyPhone 


[MS-OSHARED] - V20120122 
Office Common Data Types and Objects Structures 

Copyright © 2012 Microsoft Corporation. 



67 

68 
69 

69 

70 
70 

70 

71 
73 

m 

77 

78 
78 

78 

79 
84 
84 

84 

85 

86 
87 
87 

87 

88 
88 
88 
88 
89 
89 
89 
89 

89 

90 
90 
90 
90 
90 
90 

90 

91 
91 
91 
91 
91 
91 
96 
96 
98 
98 

98 

99 
99 
99 


Release: Sunday, January 22, 2012 



2.3.6. 1.4.6 CompanyFax 

2.3.6. 1.4.7 CompanyEmail 

2.3.6. 1.4.8 CoverPageProperties 

2.3.6. 1.5 Long Properties 

2.3.6. 1.5.1 LongProp 

2.3.6. 1.5.2 Long Properties 

2. 3. 6. 2 Custom XML Data Storage Properties 

2. 3. 6.2.1 ST_Guid 

2. 3. 6. 2. 2 schemaRef 

2. 3. 6. 2. 3 schemaRefs 

2. 3. 6. 2. 4 dataStoreltem 

2.3.7 Hyperlinks 

2.3.7. 1 Hyperlink Object 

2. 3. 7. 2 HyperlinkMoniker 

2. 3. 7. 3 CompositeMoniker 

2. 3. 7. 4 AntiMoniker 

2. 3. 7. 5 ItemMoniker 

2. 3. 7.6 URLMoniker 

2.3 .7.7 URICreateFlags 

2. 3. 7. 8 FileMoniker 

2. 3. 7. 9 HyperlinkString 

2.3.8 MsoEnvelope 

2.3.8. 1 MsoEnvelopeCLSID 

2. 3. 8. 2 MsoEnvelope 

2. 3. 8. 3 EnvRecipientCollection 

2. 3. 8. 4 EnvRecipientProperties 

2. 3. 8. 5 EnvRecipientProperty 

2. 3. 8. 6 EnvRecipientPropertyBlob 

2. 3. 8.7 PT_LONG 

2. 3. 8.8 PT_NULL 

2. 3. 8.9 PT_BOOLEAN 

2.3.8.10 PT_SYSTIME 

2.3.8.11 PT_ERROR 

2.3.8.12 PT_STRING8 

2.3.8.13 PT_UNICC)6e.,* 

2.3.8.14 PT_BINARY 

2.3.8.15 PT_MV_STRING8 

2.3.8.16 PT_MV_BINARY 


<i 


2.3.8.17 EnvAttachmentCollection 

2.3.8.18 EnvAttachment 

2.3.8.19 IntroText 

2.3.9 Document Signature Serialized Certificate Store Structure. 

2.3.9. 1 DocSigSerializedCertStore 

2.4 Common Algorithms 

2.4.1 Unicode String to Unsigned Integer Hash 

2.4.2 Hyperlink Hash 

2.4.3 MsoCrc32Compute 

2.4. 3.1 Caching Algorithm 

2.4. 3. 2 CRC Computation 

2.4.4 Date/Time Format from Format Index 

2.4.4. 1 Format Indices 

2.4.4. 2 Base Format Strings 

2.4.4. 3 Retrieve Format 


[MS-OSHARED] - V20120122 
Office Common Data Types and Objects Structures 

Copyright © 2012 Microsoft Corporation. 


.. 99 
.. 99 
.. 99 
.. 99 
.100 
.100 
.100 
.100 
.100 
.100 
.101 
.101 
.101 
.103 
.103 
il 04 
.104 
.105 
.106 
.108 
.109 
.110 
.110 
.110 
.114 
.115 
.115 
.116 
.116 
.116 
.117 
.117 
.117 
.118 
.118 
.118 
.119 
.119 
.119 
.120 
.120 
.121 
.121 
.122 
.122 
.122 
.123 
.123 
.123 
.124 
.124 
.125 


Release: Sunday, January 22, 2012 



2.4.4. 3.1 Chinese Formats 

2. 4. 4. 3. 2 Hindi Formats 

2. 4. 4. 3. 3 Japanese Formats 

2.4.4. 3.4 Korean Formats 

2. 4. 4. 3. 5 Taiwanese Formats 

2.4.4. 3.6 Thai Formats 

2. 4. 4. 3. 7 Yi Formats 

2. 4. 4. 3. 8 Formats for all other Locales. 

2. 4. 4. 4 Apply Format Exceptions 

2. 4. 4. 4.1 Bokmal (Norwegian) 

2. 4. 4. 4. 2 Czech 

2. 4. 4. 4. 3 Danish 

2.4. 4. 4.4 Dutch 

2. 4. 4. 4. 5 Finnish 

2. 4. 4. 4. 6 French Canadian 

2. 4. 4. 4. 7 German 

2. 4. 4. 4. 8 Hungarian 

2. 4. 4. 4. 9 Italian 

2.4.4.4.10 Japanese 

2.4.4.4.11 Kazakh 

2.4.4.4.12 Khmer 

2.4.4.4.13 Korean 

2.4.4.4.14 Lao 

2.4.4.4.15 Lithuanian 

2.4.4.4.16 Polish 

2.4.4.4.17 Portuguese 

2.4.4.4.18 Russian 

2.4.4.4.19 Spanish 

2.4.4.4.20 Swedish 

2.4.4.4.21 Tibetan 

2.4.4.4.22 Uzbek Cyrillic 

2.4.4.4.23 Vietnamese 

2.4.4.4.24 Bhutanese 


<i 


3 Structure Examples 

3.1 Toolbar Customization Examples 

3.1.1 Toolbar Control Example 

3.1.2 Toolbar Delta Example 

3.2 Document Summary Information Examples 

3.2.1 Document Summary Information Stream Overview 

3.2.2 Document Summary Information Property Set Overview 

3.2.2. 1 CodePage Property Example 

3. 2. 2. 2 Category Property Example 

3. 2.^3 LineCount Property Example 

3. 2.2. 4 OnksDirty Property Example 

3. 2. 2. 5 DocumentParts Property Example 

3. 2. 2. 6 HeadingPairs Property Example 

) 3.2.3 User Defined Property Set Overview 

3.2.3. 1 Dictionary Property Example 

3. 2. 3. 2 LinkBase Property Example 

3. 2. 3. 3 Hyperlinks Property Example 

3. 2. 3. 3.1 LinkElement-1 Example 

3. 2. 3. 3. 2 LinkElement-2 Example 


[MS-OSHARED] - V20120122 
Office Common Data Types and Objects Structures 

Copyright © 2012 Microsoft Corporation. 


.125 

.126 

.126 

.127 

.128 

.129 

.129 

.130 

.132 

.132 

.132 

.132 

.132 

.133 

.133 

k33 

.133 

.133 

.133 

.134 

.134 

.134 

.134 

.134 

.134 

.134 

.134 

.135 

.135 

.135 

.135 

.136 


137 

.137 

.137 

.142 

.144 

.146 

.148 

.152 

.153 

.153 

.154 

.154 

.157 

.159 

.162 

.165 

.166 

.167 


Release: Sunday, January 22, 2012 



3. 2. 3. 3. 3 LinkElement-3 Example 171 

3. 2. 3. 3. 4 LinkElement-4 Example 172 

3. 2. 3. 3. 5 LinkElement-5 Example 174 

3. 2. 3. 3. 6 LinkElement-6 Example 176 

3. 2. 3. 4 Linked Property Example 178 

3.3 SmartTag Examples 179 

3.4 Visual Basic for Applications Digital Signature Example Structures 184 

4 Security Considerations 189 

4.1 Toolbar Customization 189 

4.2 Property Set Storage 189 

4.3 Visual Basic for Applications Digital Signature 189 

5 Appendix A: Product Behavior 190 

6 Change Tracking 199 


6 Change Tracking 199 



8/205 


[MS-OSHARED] - V20120122 
Office Common Data Types and Objects Structures 

Copyright © 2012 Microsoft Corporation. 


Release: Sunday, January 22, 2012 



1 Introduction 


This document specifies the Office Common Data Types and Objects Structure, which provides a 
collection of common data types, objects, and algorithms used by various Microsoft Office 
application binary file formats. While the structure of the persistence of the data types and objects is 
specified in this document, their location in the binary formats is determined by the host application. 

Sections 1.7 and 2 of this specification are normative and contain RFC 2119 language, 
sections and examples in this specification are informative. 


ge. All other 


1.1 Glossary 

The following terms are defined in rMS-GLOSl : 

American National Standards Institute (ANSI) character set 

big-endian 

code page 

Component Object Model (COM) 

Coordinated Universal Time (UTC) 
cyclic redundancy check (CRC) 
digital certificate 
GUID 

language code identifier (LCID) 
little-endian 
MD5 hash 
object 
Unicode 

Universal Naming Convention (UNC) 

The following terms are defined i 


doi 

U 
a: 

hyi 
hyi 


absolute path 
accelerator key 
ActiveX control 
adaptive menu 
add-in 
assembly 
base URL 
basic toolbar 
ButtonPopup conti 
cell 

class identifier (CLSID) 
CLSID 

custom toolbar 
custom toolbar control 
datasheet 
digital signature 
docked 
docking area 
"xpandingGrid control 
aphicDropDown control 
UID_NULL 
ash 

hyperlink 
hyperlink location 


.<<> 
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Joint Photographic Experts Group (JPEG) 

linked object 

locale 

locale settings 
major version 
managed code 


MD5 

menu toolbar 
minor version 
moniker 

Object Linking and Embedding (OLE) 
OCXDropDown control 
Pane control 

parent directory indicator 

Popup control 

range 

relative path 
SHA-1 

smart document 
smart tag 

smart tag recognizer 

SplitButtonMRUPopup control 

SplitButtonPopup control 

SplitDropDown control 

storage 

stream 

thumbnail 

time stamp authority 

timestamp 

toolbar 

toolbar control 

toolbar control identifier (TCID) 

toolbar delta 

ToolTip 

Uniform Resource Identifier (URI) 
Uniform Resource Locator (URL) 

URI fragment 
URI query 
URI scheme 
VBA 

Visual Basic for Applications (VBA) 
whitespace 










XML namespace 
XML schema 

The following terms are specific to this document: 

anti-moniker: A Component Object Model (COM) object that is the inverse of a simple moniker 
and has no internal structure; it is the inverse of a COM implementation of a file, an item, or a 
pointer moniker. An anti-moniker that is composed to the right of a file moniker, item 
moniker, or pointer moniker composes to nothing. 
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clipboard format: An unsigned integer that uniquely identifies the format of a data packet that 
is stored in a binary large object (BLOB) and can be shared between processes through the 
operating system clipboard or other means. 


composite moniker: A Component Object Model (COM) object that joins two or more moniker 
objects and that can determine the relation between the parts. There are two types of 
composite monikers: generic, which can connect any two monikers regardless of class; and, 
nongeneric, which can connect monikers only of the same class. 

context menu: A menu that is related to the active window, selection, or object. Also referred to 
as shortcut menu. 

digital certificate store: A database that stores a variety of digital certificates and information 
about those certificates, including attributes and constraints. 

docked location: A specific position of a toolbar within the docking area of an application 
window. 

document workspace: A document repository that enables users to collaborate on one or more 
documents. 

file moniker: A Component Object Model (COM) object that stores the path name that is 
assigned to a file by the native file system. 

Gauge control: A type of control that displays and sets a value from a continuous range of 
possible values that the user selects by dragging a slider. An example is the Zoom control in 
an application window. 

GraphicCombo control: A type of ComboBox control that can display both text and graphics as 
a list of options. 

Grid control: A type of menu control that can be activated by clicking a cell in a grid. An 
example is the Font Color control. 

hyperlink target: A portion of a hyperlink that specifies the document, object, or other 
resource; for example "C:\Documents\Document.docx" in the hyperlink location 
C:\Documents\Document.docx#bookmark. 

item moniker: A Component Object Model (COM) object that identifies an object that is 
contained in another object, such as an OLE object that is embedded in a document. 

MS-DOS path compatibility mode: A mode that converts an MS-DOS® path into a 

corresponding path by mapping MS-DOS device names to MS-DOS devices and drive letters. 

target frame: The name of a frame that is in an HTML-based frames page and displays the 
destination of a hyperlink. 

A 

toolbar control separator: A line that separates groups of controls on a user interface surface, 
such as controls on a toolbar or commands on a menu. 

toolbar control type: A set of pre-defined behaviors and user interface elements for an object 
that can be implemented on a toolbar. Types include: ActiveX®; Button; ButtonPopup; 
ComboBox; DropDown; Edit; ExpandingGrid; Gauge; GraphicCombo; GraphicDropDown; Grid; 
Label; OCXDropDown; Popup; SplitButtonPopup; SplitButtonMRUPopup; and SplitDropDown. 

top-level toolbar: A basic toolbar that is not contained by another toolbar. 
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URL moniker: A Component Object Model (COM) object that stores a Uniform Resource Locator 
(URL) as a string, based on either a full URL or the combination of a base URL and a partial 
URL string. 

XML expansion pack: A collection of files, managed by a manifest. xml file, that adds 
functionality to a document by specifying custom displays or actions. 

MAY, SHOULD, MUST, SHOULD NOT, MUST NOT: These terms (in all caps) are used as 
described in rRFC21191 . All statements of optional behavior use either MAY, SHOULD, or 
SHOULD NOT. 

1.2 References 

References to Microsoft Open Specification documents do not include a publishing yea 
are to the latest version of the documents, which are updated frequently. Reference- 
documents include a publishing year when one is available. 

1.2.1 Normative References 

We conduct frequent surveys of the normative references to assure tl 
you have any issue with finding a normative reference, please contact d 
will assist you in finding the relevant information. Please check the arch 
http://msdn2.microsoft.com/en-us/librarv/E4BD6494-06AD-4a^ 

additional source. 

[ECMA-376] ECMA International, "Office Open XML File Form! 

ations/ 


[ITUX680-1994] ITU-T, "Information Technology— Absi 
Specification of Basic Notation", ITU-T Recommi 
REC-X.680-199407-S/en 


[MS-CTDOC] Microsoft Corporation, " Word Cl 
S pecification ". 

[MS-CTXLS] Microsoft Corporation, " Excel Custom 
Specification ". 



2006, http://www.ecma-international.org/publications/standards 

ti 

^ulyi 

inarv File Format Structure 


to olbar Binary File Format Structure 


[MS-DOC] Microsoft Corporation, " Word E 


/ File Format (.doc) Structure Specification ". 


[MS-DTYP] Microsoft Corporation, " Windows Data Types ". 

[MS-EMF] Microsoft Corporation, " Enhanced Metafile Format ". 

[MS-IPFF] Microsoft Corporation, " InfoPath Form Template Format ". 

[MS-LCID] Microsoft Corporation, " Windows Language Code Identifier (LCID) Reference ". 
[MS-LISTSWS] Microsoft Corporation, " Lists Web Service Protocol Specification ". 

[MS-ODRAW] Microsoft Corporation, " Office Drawing Binary File Format Structure Specification ". 
[MS-OFFCRYPTO] Microsoft Corporation, " Office Document Cryptography Structure Specification ". 
[MS-OFORMS] Microsoft Corporation, " Office Forms Binary File Format(s) ". 
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[MS-OLEPS] Microsoft Corporation, " Object Linking and Embedding COLE') Property Set Data 
Structures ". 


[MS-OVBA] Microsoft Corporation, " Office VBA File Format Structure Specification ". 
[MS-OXCDATA] Microsoft Corporation, " Data Structures ". 



[MS-OXPROPS] Microsoft Corporation, " Exchange Server Protocols Master Property List ". 

[MS-WMF] Microsoft Corporation, " Windows Metafile Format ". 

[MS-WSSCAML] Microsoft Corporation, " Collaborative Application Markup Language (CAMLJ 
Structure Specification ". 

[MS-XLS] Microsoft Corporation, " Excel Binary File Format f.xls) Structure Specificatioi 

[PKCS7] RSA Laboratories, "PKCS #7: Cryptographic Message Syntax Standard", PK( 

1.5, November 1993, http://www.rsa.com/rsalabs/node.asp7id = 2 129 

[PKCS9] RSA Laboratories, "PKCS #9: Selected Attribute Types", PKCS #9, version 1.1, No\ 

1993, http://www.rsa.com/rsalabs/node.asp7id =2131 

[RFC1321] Rivest, R., "The MD5 Message-Digest Algorithm", RFC 1321, April 1992, 
http://www.ietf.org/rfc/rfcl321.txt 

[RFC2119] Bradner, S., "Key words for use in RFCs to Indicate Requirement Levels", BCP 14, RFC 
2119, March 1997, http : //www. rfc-editor.org/rfc/rfc21 19 .txt 

[RFC3280] Housley, R., Polk, W., Ford, W., and Solo, D., "Internet X.509 Public Key Infrastructure 
Certificate and Certificate Revocation List (CRL) Profile", RFC 3280, April 2002, 
http://www.ietf.org/rfc/rfc3280.txt 

[RFC3986] Berners-Lee, T., Fielding, R., and Masinter, L., "Uniform Resource Identifier (URI): 
Generic Syntax", STD 66, RFC 3986, January 2005, http://www.ietf.org/rfc/rfc3986.txt 

[RFC5234] Crocker, D,, Ed., and Overell, P., "Augmented BNF for Syntax Specifications: ABNF", STD 
68, RFC 5234, January 2008, http://www.rfc-editor.org/rfc/rfc5234.txt 

[W3C-XSD] World Wide Web Consortium, "XML Schema Part 2: Datatypes Second Edition", October 
2004, http://www.w3.org/TR/2004/REC-xmlschema-2-20041Q28 


1.2.2 Informative References 

[FIPS180-2] Federal Information Processing Standards Publication, "Secure Flash Standard", FIPS 
PUB 180-2, August 2002, http://csrc.nist.gov/publications/fips/fipsl80-2/fipsl80-2.pdf 

[MSDN-AVSTOS] Microsoft Corporation, "Architecture of Visual Studio Tools for Office Solutions", 
http://msdn.microsoft.com/en-us/librarv/zkhw8h59(VS.80).aspx 

[MSDN-CreateUri] Microsoft Corporation, "CreateUri Function", http://msdn.microsoft.com/en- 
us/librarv/ms775098(VS.85’).aspx 

[MSDN-FM] Microsoft Corporation, "File Monikers", http://msdn.microsoft.com/en- 
us/libra rv/ms688670(VS.85Taspx 

[MSDN-IDPD] Microsoft Corporation, "Interpreting Data Packet Diagrams", 
http://msdn.microsoft.com/en-us/librarv/aa50621Q.aspx 
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[MSDN-IMAMI] Microsoft Corporation, "IMoniker— Anti-Moniker Implementation", 
http://msdn.microsoft.com/en-us/librarv/ms682346fVS.85I.aspx 


[MSDN-IMCOM] Microsoft Corporation, "Item Monikers (COM)", http://msdn.microsoft.com/en- 
us/librarv/ms693722(VS.85).aspx 

[MSDN-IMGCMI] Microsoft Corporation, "IMoniker— Generic Composite Moniker Implementation", 
http ://msdn. microsoft.com/en-us/librarv/ms688541fVS. 85).aspx 

[MSDN-SDO] Microsoft Corporation, "Smart Documents Overview", Office 2003 Smart Document 
Software Development Kit, http://msdn. microsoft. com/en-us/librarv/aal93956f office. ll).aspx 

[MSDN-URLM] Microsoft Corporation, "URL Monikers", http://msdn.microsoft.com/en- 
us/librarv/ms688580fVS.85).aspx 

[MS-GLOS] Microsoft Corporation, " Windows Protocols Master Glossary " 

[MS-OFCGLOS] Microsoft Corporation, " Microsoft Office Master Glossary ". 

[MS-PPT] Microsoft Corporation, " PowerPoint Binary File Format f.ppt) Str 

1.3 Structure Overview (Synopsis) 

1.3.1 Toolbar Customization 

Toolbar customization structures provide a run-time solution for the i 
toolbar customizations that are specific to the content of a file. 



i and deployment of 


The following diagram illustrates how toolbar customization structures are presented within the XCB 
binary stream, as described in fMS-XLSl section 2.1.7.10 with its toolbar customization structures. 



olbar customization structures in an XCB binary stream 

e following diagram illustrates how toolbar customization structures are presented within the 
able Stream, as described in rMS-DOCl section 2.1.2. 
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Summary Information Property Set (section 2. 3. 3. 2.1 ') and Document Summary Information 
Property Set (section 2. 3.3. 2. 2 ) contain a predefined set of properties, storing information such as 
title, subject, keywords, author, and line count. The User Defined Property Set (section 2. 3. 3. 2. 3) 
contains a set of properties that an application or user can extend. 




The following two diagrams illu 
file. These property sets are im 
Property Sets, see fMS-OLEPSI 


illustrate the structure of these property sets as persisted to a binary 
*e implementations of OLE Property Sets. For a structural overview of OLE 
'LEPSji section 1.3. 
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Figure 3: Property set storage structure 


| Property Set Packet ~| <^ 



Figure 4: Property 

1.3.3 RefEdit Coi 

A RefEdit control (sectio( ft2^3.5 ) cHlipylays a range value that references cells in a datasheet. A 
user can enter the value into the control directly or click a drop-down box to select it. The format of 
the range value depends on the datasheet implementation. 

1.3.4 Visual Basic for Applications Digital Signature 

Visual Basic for Applications (VBA) digital signature structure (section 2.3.2) is contained in 
pping structure that is specific to the mechanism the file format uses to store the signature. 

le formats described in fMS-XLSl and rMS-PPTl . the signature structure is stored in the 
jment Summary Information OLE property set (section 2.3.3.2.2.1) as a VT_BLOB 
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TypedPropertyValue property. The following diagram illustrates the relative structures for this 
storage mechanism. 


VT_BLOB header 




(See the figures titled Property set storage structure and 
Property set packet structure in section 1.3.2 for details 
the location of PropertyData) 


Figure 5: VBA digital signature storage as OLE property set property 

In the format described in rMS-DOCl. the signature structure is stored in the StwUsei 
( rMS-DOCl section 2.9.298) as the value of a Unicode string variable named "Sign", 
diagram illustrates the relative structures for this storage mechanism. 



Figure 6: VBA digital signatui 


•rage as [MS-DOC] string table variable 


The signature structure consists of information about the digital signature (2), as well as the 
signature (section 2.3.2 4) itself, and a serialized certificate store (section 2. 3. 2. 5. 5) . The following 
diagram illustrates this structure. 



[MS-OSHARED] - V20120122 
Office Common Data Types and Objects Structures 


Copyright © 2012 Microsoft Corporation. 
Release: Sunday, January 22, 2012 


DigSignlnfoSerialized 


1 DigSiglnfoSerialized header 


K 


VBA Digital Signature 


Serialized Certificate Store 




Timestamp URL 


Figure 7: DigSiglnfoSerialized structure 
1.3.5 Byte Ordering 

Data in the Office Common Data Types and Objects Structure is stored in little-endiai 

Some computer architectures number bytes in a binary word from left to right, which is referred to 
as big-endian. The packet diagrams (described in [MSDN-IPPPl j for this documentation are big- 
endian. Other architectures number the bytes in a binary word from right to left, which is referred to 
as little-endian. The underlying file format enumerations, objects, and records are little-endian. 

Using big-endian and little-endian methods, the number 0x12345678 would be stored as shown in 
the following table. 



Byte order 

ByteO 

Bytel 

Byte 2 

Byte 3 

Big-endian 

0x12 

0x34 

0x56 

0x78 

Little-endian 

0x78 

0x56 

0x34 

0x12 


1.4 Relationship to Protocols and Other Structures 
1.4.1 Toolbar Customization 

The CTB and TBC structures described in XLS1 section 2.6, and the CTB and TBC structures 
described in rMS-DOCl section 2.9 depend on the toolbar customization structures specified in this 
document. 

The TBCHeader (section 2.3.1.10 j. TBCSFIaqs (section 2.3.1.12 ). and TBCMenuSpecific (section 
) structures specified in this document are dependent on the toolbar customization data 
described in the following references: 

rMS-CTDOCI for the persistence format for word processing documents. 

rMS-CTXLSI for the persistence format for spreadsheet toolbar customization structures defined 
in this document. 


G 
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1.4.2 Property Set Storage 


The OLE Property Sets (section 2.3. 3. 2) specified in this document are implementations of Object 
Linking and Embedding (OLE) Property Set Data Structures (OLEPS) as described in rMS-OLEPSl . 
This document describes where rMS-DOCl . rMS-PPTl. and fMS-XLSI file formats extend [MS-OLEPS] 
and where they deviate from [MS-OLEPS]. 

These property sets are contained in persistence formats described in [MS-XLS], [MS-DOC], and 
[MS-PPT], Some data in the property sets is generated according to algorithms specified in [MS- 
ODRAW1 , [MS-DOC], and [MS-XLS]. 

1.4.3 Visual Basic for Applications Digital Signature 

The digital signature for a VBA project is a specific implementation of the PKCS #7 Cryptographic 
Message Syntax Standard as described in [PKCS71 . Additional implementation information for 
attributes of the signature is described in rPKCS91 . The file formats rMS-XLSI and rMS-PPTl store 
their VBA digital signature in their OLE Property Sets (section 2. 3. 3. 2) . The file format rMS-DOCl 
stores the VBA digital signature in a string table within the document. The data that the VBA digital 
signature encrypts is described in the [MS-OVBA1 specification. 

1.5 Applicability Statement 

The structures in this document are intended to function as persistence formats for portions of a 
document, and are not intended for stand-alone use. These persistence formats provide 
interoperability with applications that create or read documents conforming to this structure <l> . 

1.5.1 Toolbar Customization 

Toolbar customization structures represent a common model for storing custom toolbars or toolbar 
alterations within the rMS-DOCl and [MS-XLS] JB jfc-lfaHnats. Toolbar customization structures can be 
used whenever it is desirable to have custom toolbar controls (for example, custom toolbar 
controls that run cu ' : from one system to another. 

1.5.2 Property S< 



OLE Property Sets (s^ 

the rMS-DOCl. rMS-Pf 


^present a common way to store metadata about a file within 
-SI file formats in a way that is discoverable to other software. 


1.5.3 Visual Basic for Applications Digital Signature 

The digital signature for a VBA project represents a way to securely identify the author of the 
executable VBA code that is associated with the document by means of a public digital certificate. 
By securely identifying the author, a future user of the document can make a decision to trust or 
reject the executable document content based on the signer's identity. A digital signature also 
allows a future user to determine whether the content of the document's executable code is no 
longer the same as the code that was originally signed, which means that the code can no longer be 
trusted to have come from the signer identified by the accompanying digital certificate. 



.1 Toolbar Customization 


Versioning and Localization 


This document covers versioning issues in the following areas: 
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Structure Versions: There is only one version of the toolbar customization structures. 
Localization: The toolbar customization structures define no locale-specific processes or data. 


1.6.2 Property Set Storage 

This document covers versioning issues in the following areas: 

■ Structure Versions: There is only one version of the property sets defined in Property Set 
Storage (section 2.3.3) . 

■ Localization: The encoding of strings contained in the Lpstr (section 2.3. 3. 1.4 ) data typ< 
the Unaliqned Lpstr (section 2.3.3. 1. 5) data type depend on the property set's CodePaai 
property (described in rMS-OLEPSl section 2.18.2). 

1.6.3 Visual Basic for Applications Digital Signature 

This document covers versioning issues in the following areas: 

■ Structure Versions: There is only one version of the VBA digital sign 
Basic for Applications Digital Signature Storage (section 2.3.2 T 

■ Localization: The VBA digital signature structures define no la 

1.7 Vendor-Extensible Fields 

1.7.1 Toolbar Customization 

None. 

1.7.2 Property Set Storage 

None. 
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2 Structures 


2.1 Common ABNF Definitions 

The following are common ABNF (£RFC5234J) definitions for the standard ASCII and Unicode 
characters. 




B^PER-H = %x4 8 
Tp I T AL^^KER-^^BKc 4 9 
jAPITAL-lSfllfR-cI* %x4A 
.PITAL-LETTER-K = %x4B 
T AL-LETTER-L = %x4C 
c M | te AL-LETTER-M = %x4D 
CAE^^^LETTER-N = %x4E 
CAPII^PlETTER- 0 = %x4F 
CAPITAL-LETTER-P = %x50 
CAPITAL-LETTER-Q = %x51 
CAPITAL-LETTER-R = %x52 
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ASCII-SMALL-LETTER-A / 
ASCII-SMALL-LETTER-B / 
ASCII-SMALL-LETTER-C / 
ASCII-SMALL-LETTER-D / 
ASCII-SMALL-LETTER-E / 
ASCII-SMALL-LETTER-F / 
ASCII-CAPITAL-LETTER-A / 
ASCII-CAPITAL-LETTER-B / 
ASCII-CAPITAL-LETTER-C / 
ASCII-CAPITAL-LETTER-D / 
ASCII-CAPITAL-LETTER-E / 
ASCII-CAPITAL-LETTER-F 

ASCII-ALL = %x20-7F 

UTF1 6-CHAR-NON-ASCII = %x0080-FFFF 

UTF16-ANY = ASCII-ALL / UTF1 6-CHAR-NON-ASCII 


2.2 Data Types 

2.2.1 Common Data Types 

2. 2. 1.1 ObjectUpdateEnum 

Specifies how the container updates the linked object embed 



Name 

Value 

Meaning 

OU_Always 

0x00000001 

The container updates the linked object whenever there is an update 
associated with it. 

OU_OnCall 

0x00000003 

The container updates the linked object only when the container calls its 
update method. 


2. 2. 1.2 DataViewAspectEnum 

Specifies the desired data or view aspect of the object(3) when drawing or obtaining data. 


Name 

Value 

Meaning 

OR_Content 

0x00000001 1 

Specifies that the object(3) is displayed as an embedded object(3) 
inside of a container. 

OR_Thumbnail 

Q«TO000<^ 

Specifies that the object(3) is displayed as a thumbnail image. 

OR_Icon 

0x00000004 

Specifies that the object(3) is displayed as an icon. 

OR_DocPrint 

0x00000008 

Specifies that the object(3) is displayed on the screen as though it 
were printed to a printer. 


23 / 205 


[MS-OSHARED] - V20120122 
Office Common Data Types and Objects Structures 

Copyright © 2012 Microsoft Corporation. 

Release: Sunday, January 22, 2012 


2.2. 1.3 MSONFC 


This specifies the list of numbering formats that can be used for a group of automatically numbered 
objects. The numbering format values are mapped to the ST_NumberFormat ( TECMA-3761 partition 
IV section 2.18.66) enumeration equivalents as described in the following table. 


Name 

Value 

Meaning 

msonfcArabic 

0x00 

decimal 

msonfcUCRoman 

0x01 

upperRoman 

msonfcLCRoman 

0x02 

lowerRoman 

msonfclICLetter 

0x03 

upperLetter 

msonfcLCLetter 

0x04 

lowerLetter 

msonfcOrdinal 

0x05 

ordinal 

msonfcCardtext 

0x06 

cardinalText 

msonfcOrdtext 

0x07 

ordinalText 

msonfcHex 

0x08 

hex 

msonfcChiManSty 

0x09 

Chicago 

msonfcDbNuml 

OxOA 

ideographDigital 

msonfcDbNum2 

OxOB 

japaneseCounting 

msonfcAiueo 

OxOC 

Aiueo 

msonfclroha 

0x0 D 

Iroha 

msonfcDbChar 

0x0 E 

decimalFullWidth 

msonfcSbChar 

JQxOF < 

decimalHalfWidth 

msonfcDbNum3 

0x10 

japaneseLegal 

msonfcDbNum4 

0x11 

^japaneseDigitalTenThousand 

msonfcCirclenum 

0x12 

decimalEnclosedCircle 

msonfcDArabic 

0x1® 

decimalFullWidth2 

msonfcDAiueo 

0x14 

aiueoFullWidth 

msonfcDIroha 

j||l 

irohaFullWidth 

msonfcArabicLZ 

0x16 

decimalZero 

msonfcBullet 

0x17 

bullet 

msonfcGanada 

0x18 

ganada 

msonfcChosung 

0x19 

chosung 

msonfcGBl 

OxlA 

decimalEnclosedFullstop 
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Name 

Value 

Meaning 

msonfcGB2 

OxlB 

decimalEnclosedParen 

msonfcGB3 

OxlC 

decimalEnclosedCircleChinese 

msonfcGB4 

OxlD 

ideographEnclosedCircle 

msonfcZodiacl 

OxlE 

ideographTraditional 

msonfcZodiac2 

OxlF 

ideographZodiac 

msonfcZodiac3 

0x20 

ideographZodiacTraditional 

msonfcTpeDbNuml 

0x21 

taiwaneseCounting 

msonfcTpeDbNum2 

0x22 

ideographLegalTraditional 

msonfcTpeDbNum3 

0x23 

taiwaneseCountingThousand 

msonfcTpeDbNum4 

0x24 

taiwaneseDigital 

msonfcChnDbNuml 

0x25 

chineseCounting 

msonfcChnDbNum2 

0x26 

chineseLegalSimplified 

msonfcChnDbNum3 

0x27 

chineseCountingThousand 

msonfcChnDbNum4 

0x28 

decimal 

msonfcKorDbNuml 

0x29 

koreanDigital 

msonfcKorDbNum2 

0x2A 

koreanCoupting 

msonfcKorDbNum3 

0x2B 

koreanLegal 

msonfcKorDbNum4 

0x2C 

koreanDigital2 

msonfcHebrewl 

0x2D 

hebrewl 

msonfcArabicl 

0x2E 

arabicAlpha 

msonfcHebrew2 

0x2F 

hebrew2 

msonfcArabic2 

0x30 

arabicAbjad 

msonfcHindil 

0x31 

hifftiVowels 

msonfcHindi2 

0x32 

hindiConsonants 

msonfcHindi3 

o£ 

hindilMumbers 

msonfcHindi4 

0x34 

hindiCounting 

msonfcThail 

0x35 

thaiLetters 

msonfcThai2 

0x36 

thaiNumbers 

msonfcThai3 

0x37 

thaiCounting 

msonfcVietl 

0x38 

vietnameseCounting 
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Name 

Value 

Meaning 

msonfcNumlnDash 

0x39 

numberlnDash 

msonfcLCRus 

0x3A 

russianLower 

msonfcUCRus 

0x3B 

russianUpper 

msonfcNone 

OxFF 

Specifies that the sequence will not display any numbering 


2. 2. 1.4 WebScreenSizeEnum 

An enumeration that specifies the screen resolution for the target monitor on which the Web page is 
to be displayed. Values are described in the following table. 


Name 

Value 

Meaning 

MSOWOPTScreenSize544x376 

0x00 

544 by 376 pixels 

MSOWOPTScreenSizeWebTV 

0x00 

544 by 376 pixels 

MSOWOPTScreenSize640x480 

0x01 

640 by 480 pixels 

MSOWOPTScreenSize720x512 

0x02 A 

720 by 512 pixels 

MSOWOPTScreenSize800x600 

0x03 

800 by 600 pixels 

MSOWOPTScreenSizel024x768 

0x04 \ 

1024 by 768 pixels 

MSOWOPTScreenSizel 152x882 

0x05 

1152 by 882 pixels 

MSOWOPTScreenSizel 152x900 

.0x06^ 

1152 by 900 pixels 

MSOWOPTScreenSizel 280x1024 

0x07 

1280 by 1024 pixels 

MSOWOPTScreenSizel600xl200 

OxW* 

1600 by 1200 pixels 

MSOWOPTScreenSizel800xl440 

0x09 

1800 by 1440 pixels 

MSOWOPTScreenSizel920xl200 

OxOA 

1920 by 1200 pixels 


2. 2. 1.5 FilePointer 

Specifies the offset into the stream (1) or file that is to be read from or written to. 
offset (4 bytes): Unsigned integer that specifies the offset into a stream or file. 

2.2. 1.6 FixedPoint 

I an approximation of a real number, where the approximation has a fixed number of digits 
radix point. 

Value real number = Integral + (Fractional / 65536.0) 


Specifies c 
“fter the r 

tegral | 
-ctiona 




tegral (2 bytes): A signed integer that specifies the integral part of the real number, 
ctional (2 bytes): An unsigned integer that specifies the fractional part of the real number. 
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2.3 Common Objects 
2.3.1 Toolbar Customization 


This section specifies structures used by the CTB, and TBC structures specified in rMS-XLSl section 
2.6, and by the CTB, and TBC structures specified in rMS-DOCl section 2.9. 

2.3. 1.1 TBCBitmap 

Referenced by: TBCBSpecific 

Specifies a bitmap used to store a custom icon used by a toolbar control. 



cbDIB (4 bytes): Signed integer that specifies the count of total bytes, excluding this field, in 
the TBCBitmap structure (section 23 ) plus 10. The value is given by the following 

formula: 


^^size^^^^ors ) 


f (bitmapData) ■ 


The value MUST be greater than or equal to 40, and MUST be less than or equal to 65576 
(which is a bitmap that is 128 pixels high, 128 pixels wide at 32 bits of color per pixel plus 40 
((128 * 128 * 32/ 8) + 40)). 

biHeader (30 bytes): A BITMAPINFOHEADER structure (section 2.3.1.2) that contains 
infoApation about this bitmap. 

colors (variable): Zero-based array of RGBOuad structures (section 2. 3.1.3) . MUST exist only if 
' leader. biBitCount is less than or equal to 0x08. The number of elements in this array 
ST be equal to 2 A biHeader .biBitCount. 

itmapData (variable): An array of bytes as specified by the aData field of a 
DevicelndependentBitmap object specified in rMS-WMFl section 2. 2. 2. 9. The number of 
bytes in this array MUST be equal to cbDIB - sizeOf (colors) - sizeOf (biHeader) -10. 
The number of bytes in this array is also calculated with the following formula: 
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Number of bytes in bitmapData = ( (biHeader. biwidth 
~31) / 8 * biHeader .biHeight 


jiHeader . biBitCount + 31; 


2. 3. 1.2 BITMAPINFOHEADER 

Referenced by: TBCBitmao 

Bitmap header. Contains information about a bitmap. 




biPlanes biBitCount 

biSizelmage 


biCompression 

biXPelsPerMeter 


biYPelsPerMeter 

biCIrlfera 


bData (4 bytes): Unsigned integer. MUST be 0x00000028. 

biWidth (2 bytes): Signed integer that specifies the width of the bitmap in pixels. MUST be 
positive and less than or equal to 0x0080. 

biHeight (2 bytes): Signed integer that specifies the height of the bitmap in pixels. MUST be 
positive and less than or equal to 0x0080. 

biPlanes (1 byte): Unsigned integer that MUST be 0x01. 

biBitCount (1 byte): Unsigned integer that specifies the number of bits per pixel. MUST be 
equal to one of the values in the following table. 



»f biBitCount 
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Value of biBitCount 

0x20 

biCompression (2 bytes): Unsigned integer that specifies the bitmap compression format. A 
value of 0x0000 means that the bitmap is uncompressed. The value MUST be 0x0000. 

biSizelmage (2 bytes): Unsigned integer that specifies the size, in bytes, of the image. The 
value SHOULD <2> specify the size of the bitmapData array of the TBCBitmap structure 
(section 2. 3. 1.1 ) that contains this structure and is given by the following formula. 


* biHeader .biBitCount H 


biXPelsPerMeter (4 bytes): MUST be 0x00000000 and MUST be ignored. 

biYPelsPerMeter (4 bytes): MUST be 0x00000000 and MUST be ignored. 

biCIrUsed (4 bytes): Unsigned integer as specified by the ColorUsed field af l fftl ! 

BitmapInfoHeader object specified in rMS-WMFl section 2. 2. 2. 3. MUST be 0x00000000. 

biCIrlmportant (4 bytes): Unsigned integer as specified by the Colorlmportant field of the 
BitmapInfoHeader object specified in rMS-WMFl section 2. 2. 2. 3. MUST be 0x00000000. 



2.3. 1.3 RGBQuad 

Referenced by: TBCBitmap 
Specifies the pixel color values in a TBCBitmap 


blue 




♦ t 

^Bitmap (section 2.3. 1.1) . 


red 


0 1 2 3 4 5 6 7 


reserved 


blue (1 byte): An unsigned integer that specifies the relative intensity of blue, 
green (1 byte): An unsigned integer that specifies the relative intensity of green, 
red (1 byte): An unsigned integer that specifies the relative intensity of red. 
reserved (1 byte): Undefined and MUST be ignored. 

2.3. 1.4 WStrir _ 

Referenced by: TB, TBCBSoecific, TBCCDData. TBCExtralnfo, TBCGenerallnfo, TBCMenuSoecific 

that toolbar customization structures use. This structure specifies a non-null- 
inicode string. 


[MS-OSHARED] - V20120122 
Office Common Data Types and Objects Structures 


Copyright © 2012 Microsoft Corporation. 
Release: Sunday, January 22, 2012 


901234567 


901234567 


cLen (1 byte): Unsigned integer that specifies the count of characters in this string. 

data (variable): Array of Unicode characters. The number of characters in the array MUST be 
equal to the value of the cLen field. Because this is a non-null-terminated Unicode string all of 
the elements of this string MUST NOT have a value of 0x0000. 

2.3. 1.5 SRECT 

Referenced by: TBVisualData 
Specifies a rectangle structure. 
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left (2 bytes): Signed integer that specifies the position in pixels of the left side of the 
rectangle. 

top (2 bytes): Signed integer that specifies the position in pixels of the top side of the 
rectangle. 

right (2 bytes): Signed integer that specifies the position in pixels of the right side of the 
rectangle. 

bottom (2 bytes): Signed integer that specifies the position in pixels of the bottom side of the 
rectangle. 

2.3. 1.6 TB 
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cRowsDefault 


name (variable) 



bSignature (1 byte): Signed integer that specifies the toolbar signature number. MUST be 
0x02. 

bVersion (1 byte): Signed integer that specifies the toolbar version number. MUST be 

cCL (2 bytes): Signed integer that SHOULD <3> specify the number of toolbar controls 
contained in this toolbar. 

Itbid (4 bytes): Signed integer that specifies the toolbar ID. MUST be 0x00000001 (custom 
toolbar ID). 

Itbtr (4 bytes): Unsigned integer of type TBTRFIaqs (section 2.3.1.7)^ Wit: specifies the toolbar 
type and toolbar restrictions. 

cRowsDefault (2 bytes): Unsigned integer that specifies the number of preferred rows for the 
toolbar when the toolbar is not docked. MUST be less than or equal to 255. 

bFlags (2 bytes): Unsigned integer of type TBFIaqs (section 2. 3. 1.8 ). 

name (variable): Structure of type WStrinq (secti<m 2.3.1.4) that specifies the toolbar name. 

2.3. 1.7 TBTRFIags 

Referenced by: TB 

Toolbar type and restrictions flags. The bit description begins from the least significant bit. 

This structure MUST specify the toolbar type which means that the 8 most significant bits MUST 

have one of the values in the following table. 


8 most significant bits of the TBTRFIags structure (section 

2. 3. 1.7) 

Meaning 

00000000 

Specifies that the toolbar is a basic 
toolbar. 

00000010 

Specifies that the toolbar is a menu 
toolbar. 


The rest of the bits in this structure specify toolbar restrictions. A toolbar restriction limits the end 
user's ability to change and manipulate the toolbar. 


HE 
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A - NoAddDelCtl (1 bit): A bit that specifies whether toolbar controls can be added to or 
removed from this toolbar. A value of 1 specifies that no toolbar controls can be added or 
removed from this toolbar. 


B - NoResize (1 bit): A bit that specifies whether this toolbar can be resized when not docked. 
A value of 1 specifies that this toolbar cannot be resized when not docked. 


C - NoMove (1 bit): A bit that specifies whether this toolbar can or cannot be moved. A value of 
1 specifies that this toolbar cannot be moved. 

D - NoChangeVisible (1 bit): A bit that specifies whether the visibility of this toolbar can be 
changed. A value of 1 specifies that the visibility of this toolbar cannot be changed. 

E - NoChangeDock (1 bit): A bit that specifies whether the docked location of this toolbar 
can or cannot be changed. A value of 1 specifies that the end user cannot change the docked 
location of this toolbar. 

F - NoVerticalDock (1 bit): A bit that specifies whether this toolbar can be vertically docked. A 
value of 1 specifies that the toolbar cannot be vertically docked. 

G - NoHorizontalDock (1 bit): A bit that specifies whether this toolbar can be horizontally 
docked. A value of 1 specifies that the toolbar cannot be horizontally docked. 

H - NoBorder (1 bit): A bit that specifies whether the toolbar has a title bar and a border when 
not docked. A value of 1 specifies that the toolbar does not have a title bar and a border when 
not docked. MUST be 1 when the TBTPopupMenu field equals 1; MUST be 0 when the 

TBTPopupMenu equals 0. 

I - NoTbContextMenu (1 bit): A bit that specifies whether the toolbar shows a context menu 

when right-clicked. A value of 1 specifies that the toolbar will not show a context menu when 

right-clicked. MUST be 1 when TBTPopupMenu equals 1; MUST be 0 when TBTPopupMenu 
equals 0. 

J - reservedl (1 bit): Reserved bit. MUST be 0. 

K - reserved2 (1 bit): Reserved bit. MUST be 0. 

L - NotTopLevel (1 bit): A bit that specifies whether the toolbar can be a top-level toolbar. A 
value of 1 specifies that this toolbar is always a child of another toolbar, and can never be a 
top-level toolbar. A value of 0 specifies that this toolbar can be a top-level toolbar. MUST be 1 
when the TBTPopupMenu field equals 1; MUST be 0 when the TBTPopupMenu field equals 
0. 


M - reserved3 (1 bit): Reserved bit. MUST be 0. 

N - reserved4 (1 bit): Reserved bit. MUST be 0. 

O - reserved5 (1 bit): Reserved bit. MUST be 0. 

P - reserved6 (1 bit): Reserved bit. MUST be 0. 

~ - reserved? (1 bit): Reserved bit. MUST be 0. 

- reserved8 (1 bit): Reserved bit. MUST be 0. 

- reserved9 (1 bit): Reserved bit. MUST be 0. 

T - reservedlO (1 bit): Reserved bit. MUST be 0. 
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U - reservedll (1 bit): Reserved bit. MUST be 0. 

V - reservedl2 (1 bit): Reserved bit. MUST be 0. 

W - reservedl3 (1 bit): Reserved bit. MUST be 0. 

X - reservedl4 (1 bit): Reserved bit. MUST be 0. 

Y - reservedl5 (1 bit): Reserved bit. MUST be 0. 

Z - TBTPopupMenu (1 bit): A bit that specifies whether this toolbar is of type menu toolbar. A 
value of 1 specifies that this is a menu toolbar. If the value equals 1, the fields NoResize, 
NoMove, NoChangeDock, NoBorder, NoTbContextMenu, and NotTopLevel MUST equal 

a - reserved 16 (1 bit): Reserved bit. MUST be 0. 
reservedl7 (5 bits): Reserved bits. MUST be 0. 

2.3. 1.8 TBFIags 

Referenced by: TB 

Toolbar flags. The bit description begins from the least significant® 
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A - fDisabled (1 bit): A bit that specifies whether this toolbar is disabled. A value of 1 specifies 
that this toolbar is disabled. 

B - reservedl (1 bit): Undefined and MUST be ignored. 

C - fCtIModified (1 bit): A bit that specifies whether the toolbar controls of this toolbar have to 
be saved to the file. A value of 1 specifies that the toolbar controls of this toolbar have to be 
saved to the file; MAY be 0 and the toolbar MAY still save its toolbar controls to the file. <4> 

D - fNoAdaptiveMenus (1 bit): A bit that specifies whether adaptive menus are disabled for 
this toolbar. A value of 1 specifies that adaptive menus are disabled for this toolbar. 

E - fNeedsPositioning (1 bit): A bit that specifies whether the toolbar's non-docked position 
needs to be updated for display on multiple monitors. A value of 1 specifies that the toolbar's 
non-docked position needs to be updated for display on multiple monitors. 

reserved2 (11 bits): Reserved bits. MUST be 0. 

2.3. 1.9 TBVisualData 

Contains visual information about a toolbar. The values of some of the fields in this structure are 
restricted by the toolbar type and restrictions of this toolbar (the value of the Itbtr field of the IB 
structure (section 2. 3.1.6) that contains the structure that contains this structure). The restrictions 
are shown in the following table. 
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Value of toolbar types and restrictions flags (value of the Itbtr field of 
the TB structure that contains the structure that contains this structure) 

TBVisualData 

restrictions 

If the NotTopLevel bit of the Itbtr field of the TB structure (section 2. 3.1. 61 
that contains toolbar information for this toolbar equals 1. 

tbv MUST equal 0x00 or 
tbds MUST equal 0x04. 

If the TBTPopupMenu bit of the Itbtr field of the IB structure (section 

2.3.1.61 that contains toolbar information for this toolbar equals 1. 

tbv MUST equal 0x00 or 
tbds MUST equal 0x04. 

If the NoVerticalDock bit of the Itbtr field of the IB structure (section 

2.3.1.61 that contains toolbar information for this toolbar equals 1. 

tbds MUST NOT equal 
0x00 or 0x02. 

If the NoHorizontalDock bit of the Itbtr field of the TB structure (section 
2.3.1.61 that contains toolbar information for this toolbar equals 1. 

tbds MUST NOT equal 
0x01 or 0x03. 


0 1 2 3 4 5 6 7 

1 

8 9 0 1 2 3 4 5 

2 JJPliL Wp. 

6 7 8 9 0 1 2 3 | 4 | 5 6 j. 8 9 0 1 

tbds 

tbv 

tbdsDock ml 


rcDock 




rcFloat 





tbds (1 byte): Signed integer that specifies the current 
be in the following table. 


oolbar docked state. The value MUST 


Value 

Meaning 

0x00 

<^>lbar is^Jqfked on application frame at the left. 

0x01 

Toolbar is docked on application frame at the top. 

0x02 

^Toolbar is docked on application frame at the right. 

0x03 

Toolbar is docked on application frame at the bottom. 

0x04 

Toolbar is not docked. 




tbv (1 byte): Signed integer that specifies the toolbar visibility. The value MUST be in the 
following table. 


— 

Meaning 

0x00 

Toolbar is not visible. 

0x01 

Toolbar is visible. 
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Value 

Meaning 

0x02 

Toolbar is visible. 


tbdsDock (1 byte): Signed integer that SHOULD <5> specify the toolbar docked state. The 
value MUST be in the following table. 


Value 

Meaning 

0x00 

Toolbar is docked on application frame at the left. 

0x01 

Toolbar is docked on application frame at the top. 


0x02 

Toolbar is docked on application frame at the right. 

0x03 

Toolbar is docked on application frame at the bottom. 


ual to the 


If the value of the tbds field is less than or equal to 0x03, this value MUST be equal 
value of the tbds field. 

iRow (1 byte): Signed integer that specifies, when the toolbar is docked, the index of the 

docked location of the toolbar in the docking area in relati on to other toolbars in the docking 
area. MUST be in the range 0-127 or in the following table. 


Value 

Meaning 

OxFE (-2) 

Row append. Toolbar is placed on the last row of the docking area. 

OxFD (-3) 

Row prepend. Toolbar is placed on the first row of the docking area. 


rcDock (8 bytes): Structure of type SRECT (section 2.3. 1.5) that specifies the preferred docked 
location of the toolbar. Refer to the following table for the meaning of the values of each field 
of this structure. 



Field of rcDock 
structure 

Meaning^ 

rcDock. left 

Signed integer that specifies the distance in pixels from the left border of 
the docking area to the left border of the toolbar. 

rcDock. top 

Signed integer that specifies the distance in pixels from the top border of 
the docking area to the top border of the toolbar. 

rcDock. right 

m J 

Signed integer that specifies the distance in pixels from the left border of 
the docking area to the right border of the toolbar. 

rcDock. bottom 

Signed integer that specifies the distance in pixels from the top border of 
the docking area to the bottom border of the toolbar. 


(8 bytes): Structure of type SRECT (section 2.3.1.5) that specifies the preferred toolbar 
location when the toolbar is not docked. Refer to the following table for the meaning of the 
values of each field of this structure. 
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Field of rcFloat 
structure 

Meaning 

rcFloat.left 

Signed integer that specifies the distance in pixels from the left border of 
the screen to the left border of the toolbar. 

rcFloat.top 

Signed integer that specifies the distance in pixels from the top border of 
the screen to the top border of the toolbar. 

rcFloat. right 

Signed integer that specifies the distance in pixels from the left border of 
the screen to the right border of the toolbar. 

rdFloat. bottom 

Signed integer that specifies the distance in pixels from the top border of 
the screen to the bottom border of the toolbar. 


2.3.1.10 TBCHeader 

Toolbar control header information. 
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bSignature 

bVersion 

bFlagsTCR 

tct 

tcid 

tbct 


bPriority 

width (optional) 


height (optional) 



bSignature (1 byte): Signed integer that specifies the toolbar control signature number. MUST 
be 0x03. 

bVersion (1 byte): Signed integer that specifies the toolbar control version number. MUST be 
0x01. 

bFlagsTCR (1 byte): Structure of type TBCFIaqs (section 2.3.1.11) that specifies toolbar control 
flags. 

tct (1 byte): Unsigned integer that specifies the toolbar control type. The value MUST be in 
the following table: 




value 

Toolbar control type 

0x01 \ 

Button control 

J|02 

Edit control 

0,03 

DropDown control 

0x04 

ComboBox control 

0x06 

SplitDropDown control 

0x07 

OCXDropDown control 
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bPriority (1 byte): Unsigned integer that specifies the toolbar control priority for dropping and 
wrapping purposes. The value MUST be in the range 0x00 to 0x07. If the value equals 0x00, it 
is considered the default state. If it equals 0x01 the toolbar control will never be dropped from 
the toolbar and will be wrapped when needed. Otherwise, the higher the number the sooner 
the toolbar control will be dropped. 

width (2 bytes): Unsigned integer that specifies the width, in pixels, of the toolbar control. 
MUST only exist if bFlagsTCR-fSaveDxy equals 1. 

height (2 bytes): UnsigwLintega|that specifies the height, in pixels, of the toolbar control. 
MUST only exist if bFlagsTCR.fSaveDxy equals 1. 

2.3.1.11 TBCFIags 

Referenced by: TBCHeader 


Toolbar control flags. The bit description begins from the least significant bit. 
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A - fHidden (1 bit): A bit that specifies whether this toolbar control is visible. A value of 1 
specifies that the toolbar control is not visible. 

B - fBeginGroup (1 bit): A bit that specifies whether a toolbar control separator appears 
before this toolbar control. A value of 1 specifies that a toolbar control separator appears 
before the toolbar control. 


- fOwnLine (1 bit): A bit that specifies whether the toolbar control requires its own row. A 
value of 1 specifies that the toolbar control requires its own row in the toolbar. 

- fNoCustomize (1 bit): A bit that specifies whether this toolbar control can be altered by 
customization. A value of 1 specifies that the toolbar control cannot be altered by 
customization. 

E - fSaveDxy (1 bit): A bit that specifies whether the width and height of the tool 
have been saved to the file. A value of 1 specifies that the width and height fi 
TBCHeader structure (section 2.3.1.10) that contains this structure MUST exist. 

F - reservedl (1 bit): Reserved bit. Undefined and MUST be ignored. 

G - fBeginLine (1 bit): A bit that specifies whether the toolbar contr^ 
toolbar. A value of 1 specifies that the toolbar control begins a new r 



H - reserved2 (1 bit): Reserved bit. MUST be 0. 
2.3.1.12 TBCSFIags 

Referenced by: TBCHeader 


A - textlcon (2 bits): Unsigned integer that specifies the visibility of the label and icon of this 
toolbar control. The value MUST be in the following table: 


- 


Value(value of bits in 
parenthesis) 

Meaning - When toolbar 
control is on a basic toolbar 

Meaning - When toolbar 
control is on a menu toolbar 

0x00 (00) 

Text is not visible and icon is 
visible 

Text is visible and icon is visible. 

ttloi (01)^ 

Text is not visible and icon is 
visible 

Text is visible and icon is not 
visible 

0X02 (10) 

Text is visible and icon is not 
visible. 

Text is visible and icon is not 
visible. 

0x03 (W) 

Text is visible and icon is visible. 

Text is visible and icon is visible. 
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B - fOwnerDraw (1 bit): A bit that specifies whether this toolbar control uses an internal 
rendering option. A value of 1 specifies that this toolbar control uses an internal rendering 
option. MUST be 0 if the tcid value of the TBCHeader structure (section 2.3.1.10) that 
contains this structure equals 0x0001. If the tcid value of the TBCHeader structure that 
contains this structure does not equal 0x0001, this value MUST be equal to the value 
associated with the tcid listed in rMS-CTDOCl section 2.2 or in rMS-CTXLSl section 2.2. 

C - fAllowResize (1 bit): A bit that specifies whether sizing is allowed for this toolbar cor 1 -—' * 
value of 1 specifies that toolbar control sizing is allowed. This flag is used when a toolbi 
control is being initialized and allows for the toolbar control to be smaller or bigger thar 
normal. MUST be 0 if the tcid value of the TBCHeader structure that contains this struc 
equals 0x0001. If the tcid value of the TBCHeader structure that contains this structuff 
not equal 0x0001, this value MUST be equal to the value associated with the tcid listed 
rMS-CTDOCl section 2.2 or in rMS-CTXLSl section 2.2. 

D - fOneState (1 bit): A bit that specifies whether this is a one-state toolbar control. Thi: 
only used by toolbar controls of type Button or ExpandingGrid. A value of 1 specifies th 
toolbar control can have only one state (ButtonUp, the value of the state field of the 
TBCBSFIaqs structure (section 2.3.1.18) contained in the TBCBSpecific structure (section 
2.3.1.17) contained in the TBCData structure (section 2.3.1.13 ) that contains toolbar control 
information for this toolbar control equals 0). MUST be 0 if the tcid value of the TBCHeader 
structure that contains this structure equals 0x0001. If the tcid value of the TBCHeader 
structure that contains this structure does not equal 0x0001, this value MUST be equal to the 
value associated with the tcid listed in rMS-CTDOCl section 2.2 or in rMS-CTXLSl section 2.2. 

E - fNoSetCursor (1 bit): A bit that specifies whether the toolbar control can change the mouse 
cursor when it is over the toolbar control area. A value of 1 specifies that the toolbar control 
can change the mouse cursor when this is over the toolbar control area. MUST be 0 if the tcid 
value of the TBCHeader structure that contains this structure equals 0x0001. SHOULD <6> be 
0 if the tcid value of the TBCHeader structure that contains thislkructure does not equal 



0x0001. 


F - fNoAccel (1 bit): A bit that specifies whether this toolbar control has accelerator keys. A 
value of 1 specifies that the toolbar control does not have accelerator keys. MUST be 0 if the 
tcid value of the TBCHeader structure that contains this structure equals 0x0001. 
SHOUI.D <7> be 0 if the tcid value of the TBCHeader structure that contains this structure 
does not equal 0x0001. 

G - fChgAccel (1 bit): A bit that specifies whether the accelerator keys for the toolbar control 
can change. A value of 1 specifies that the accelerator keys can be changed by the 
application. MUST be 0 if the tcid value of the TBCHeader structure that contains this 
structure equals 0x0001. If the tcid value of the TBCHeader structure that contains this 
structure does not equal 0x0001, this value MUST be equal to the value associated with the 
tcid listed in - T CTDOC1 section 2.2 or in rMS-CTXLSl section 2.2. 

unusedl (8 bits): Undefined and MUST be ignored. 

H - fAlwaysEnabled (1 bit): A bit that specifies whether this toolbar control is enabled by 
default. A value of 1 specifies that the toolbar control is enabled by default. MUST be 0 if the 
tcid value of the TBCHeader structure that contains this structure equals 0x0001. 

SHOULD <8> be 0 if the tcid value of the TBCHeader structure that contains this structure 
does not equal 0x0001. 

■ fAlwaysVisible (1 bit): A bit that specifies whether this toolbar control is visible by default. 
A value of 1 specifies that the toolbar control is visible by default. MUST be 0 if the tcid value 
of the TBCHeader structure that contains this structure equals 0x0001. If the tcid value of the 
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TBCHeader structure that contains this structure does not equal 0x0001, this value MUST be 
equal to the value associated with the tcid listed in rMS-CTDOCl section 2.2 or in i lS-CTXLSl 
section 2.2. 

J - fNoChangeLabel (1 bit): A bit that specifies whether the label of the toolbar control can 
change. A value of 1 specifies that the toolbar control label does not be changed by the 
application. MUST be 0 if the tcid value of the TBCHeader structure (section 2.3.1.10) that 
contains this structure equals 0x0001. If the tcid value of the TBCHeader structure that 
contains this structure does not equal 0x0001, this value MUST be equal to the value 
associated with the tcid listed in rMS-CTDOCl section 2.2 or in rMS-CTXLSl section 2.2. 

K - fKeepLabel (1 bit): A bit that specifies whether the label of the toolbar control can change. 

A value of 1 specifies that the toolbar control label will not be changed by the application 
unless the toolbar control is reset. 

L - fNoQueryTooltip (1 bit): A bit that specifies whether the toolbar control can use an internal 
string as a ToolTip. A value of 1 specifies that the toolbar control will not use an internal 
string as a ToolTip. If the toolbar control has a custom ToolTip, it will always use it. MUST be 0 
if the tcid value of the TBCHeader structure (section 2.3.1.10 ) that contains this structure 
equals 0x0001. If the tcid value of the TBCHeader structure that contains this structure does 
not equal 0x0001, this value MUST be equal to the value associated with the tcid listed in 
rMS-CTDOCl section 2.2 or in rMS-CTXLSl section 2.2. 

M - fSaveUIStrings (1 bit): A bit that specifies whether none, one, or more of a variety of 
strings are saved to the file. A value of 1 specifies that one or more of the following fields will 
be saved to the file: customText, descriptionText, and tooltip fields of the TBCGenerallnfo 
structure (section 2.3.1.14 ) contained by the TBCData structure (section 2.3.1.13) contained 
by the structure that contains the TBCHeader structure (section 2.3.1.10 ) that contains this 
structure and if this toolbar control is of type Button or ExpandingGrid, the wstrAcc field of 
the TBCBSpecific structure (section 2.3.1.12^ U:ontained by the TBCData structure contained 
by the structure that contains the TBCHeader structure that contains this structure. When the 
value of the tcid field of the TBCHeader structure that contains the TBCSFIags structure 
(section 2.3.1.12 ) that contains this field equals 1, fSaveUIStrings is equal to 1, even if no 
extra strings are saved to the file. 

N - fExclusivePopup (1 bit): A bit that specifies whether the toolbar control is going to drop a 
unique custom toolbar. This bit is only used by toolbar controls that drop a menu toolbar. A 
value of 1 specifies that the toolbar control is going to drop a unique custom toolbar. 
SHOULD<9> 

O - fDefaultBehavior (1 bit): A bit that specifies whether the toolbar control will have default 
behavior during OLE merging. A value of 1 specifies that the toolbar control will have default 
behavior during OLE merging. A value of 0 specifies that the application can change the 
behavior of the toolbar control during OLE merging. SHQULD <10> be 0. 

P - unused2 (1 bit): Undefined and MUST be ignored. 

Q - fWrapText (1 bit): A bit that specifies whether the toolbar control can wrap its label across 
multiple lines. A value of 1 specifies that the label of the toolbar control can wrap across 
multiple lines. 

- fTextBelow (1 bit): A bit that specifies that the label of the toolbar control will be displayed 
under the toolbar control icon. A value of 1 specifies that the label of the toolbar control will 
be displayed under the toolbar control icon, rather than beside it. 

unused3 (4 bits): Undefined and MUST be ignored. 
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S - reservedl (1 bit): Reserved bit. MUST be 0. 


2.3.1.13 TBCData 

Toolbar control information. 



structure (section 2.3.1.10 ) contained by the structure that contains this structure. The 
following table shows the type of structure that is saved according to the type of the toolbar 
control: 


Value of the tct field 

Type of the controlSpecificInfo field 

0x01 (Button control) 

TBCBSDCCific (Xtion 2.3.1.17) 

0x10 (ExpandingGrid control) 

TBCBSpecific 

OxOA (Popup control) 

TBCMenuSoecific (section 2.3.1.21) 

OxOC (ButtonPopup dQWtrol) 

TBCMenuSpecific 

OxOD (SplitButtonPopup control) 

TBCMenuSpecific 

OxOE (SplitButtonMRUPopup control) 

TBCMenuSpecific 

0x02 (Edit control) 

TBCComboDroDdownSoecific (section 2.3.1.19) 

0x04 (C^S^Box control) 

TBCComboDropdownSpecific 

0x14 (GraphicCombo co^ol) 

TBCComboDropdownSpecific 

0x03 (DropDown control) 

TBCComboDropdownSpecific 

0x06 (SplitDropDown control) 

TBCComboDropdownSpecific 

0x09 (GraphicDropDown control) 

TBCComboDropdownSpecific 

0x07 (OCXDropDown control) 

controlSpecificInfo MUST NOT exist 

OxOF (Label control) 

controlSpecificInfo MUST NOT exist 
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Value of the tct field 

Type of the controlSpecificInfo field 

0x12 (Grid control) 

controlSpecificInfo MUST NOT exist 

0x13 (Gauge control) 

controlSpecificInfo MUST NOT exist 

0x16 (ActiveX control) 

controlSpecificInfo MUST NOT exist 


2.3.1.14 TBCGenerallnfo 

Referenced by: TBCData 



* 

O 


bFlags (1 byte): Structure of type TBCGIFIaqs (section 2.3.1.15) that specifies which of the 
fields of this structure have been saved to the file. 

customText (variable): Structure of type WStrinq (section 2.3. 1.4) that specifies the custom 
label of the toolbar control. MUST exist if bFlags.fSaveText equals 1. MUST NOT exist if 

bFlags.fSaveText equals 0. 

descriptionText (variable): Structure of type WString that specifies a description of this 
toolbar control. MUST exist if bFlags.fSaveMiscUIStrings equals 1. MUST NOT exist if 

bflags.fSaveMiscUIString equals 0. 

tooltip (variable): Structure of type WString that SHQULD <11> specify the ToolTip of this 
toolbar control. MUST exist if bFlags.fSaveMiscUIStrings equals 1. MUST NOT exist if 

bFlags.fSaveMiscUIStrings equals 0. 

ralnfo (variable): Structure of type TBCExtralnfo (section 2.3.1.16 ) that specifies extra 
information saved for a toolbar control. MUST exist if bFlags.fSaveMiscCustom equals 1. 
MUST NOT exist if bFlags.fSaveMiscCustom equals 0. 
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2.3.1.15 TBCGIFIags 


Referenced by: TBCGenerallnfo 


Toolbar control general information flags that specify which fields in the TBCGenerallnfo structure 
(section 2.3.1.14 ) that contains this structure will be saved to the file. The bit description begins 
from the least significant bit. 



01234567890123456789012345678901 


A B C D Unused 


A - fSaveText (1 bit): A bit that specifies whether the toolbar control will save its custom text. 

A value of 1 specifies that the customText field of the TBCGenerallnfo structure (section 
2.3.1.14) that contains this structure MUST exist. If the value equals 1, the value of the 
fSaveUIStrings field of the TBCSFIaqs structure (section 2.3.1.12) contained by the 
TBCHeader structure (section 2.3.1.10 ) contained by the structure that contains the TBCData 
structure (section 2.3.1.13 ) that contains the TBCGenerallnfo structure (section 2.3.1.14) that 
contains this structure MUST be 1. 

B - fSaveMiscUIStrings (1 bit): A bit that specifies whether the toolbar control will save its 
description and ToolTip strings. A value of 1 specifies that the descriptionText and tooltip 
fields of the TBCGenerallnfo structure that contains this structure MUST exist. If the value 
equals 1, the value of the fSaveUIStrings field of the TBCSFIags structure contained by the 
TBCHeader structure contained by the structure that contains the TBCData structure that 
contains the TBCGenerallnfo structure that contains this structure MUST be 1. 

C - fSaveMiscCustom (1 bit): A bit that specifies whether the toolbar control will save toolbar 
control extra information. A value of 1 specifies that the extrainfo field of the 
TBCGenerallnfo structure that contains this structure MU^rexist. 

D - fDisabled (1 bit): A bit that specifies whether the toolbar control is disabled. A value of 1 
specifies that the toolbar control is disabled. 


Unused (4 bits): Undefined and MUST be ignored. 
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wstrOnAction (variable) 


wstrParam (variable) 


wstrHelpFile (variable): A structure of type WStrinq (section 2.3.1.4) that specifies the full 
path to the help file used to provide the help topic of the toolbar control. For this field to be 
used idHelpContext MUST be greater than zero. 

idHelpContext (4 bytes): Signed integer that specifies the help context id number for the help 
topic of the toolbar control. A help context id is a numeric identifier associated with a specific 
help topic. For this field to be used wstrHelpFile MUST specify a non-empty string. 

wstrTag (variable): Structure of type WString that specifies a custom string used to store 
arbitrary information about the toolbar control. 

wstrOnAction (variable): Structure of type WString that specifies the name of the macro 
associated with this toolbar control. 

wstrParam (variable): Structure of type WString that specifies a Custom string used to store 
arbitrary information about the toolbar control. 

tbcu (1 byte): Signed integer that specifies how the toolbar control will be used during OLE 
merging. The value MUST be in the following table. 







Value 

Meaning 

OxFF 

A correct value was not found for this toolbar control. A value of 0x01 will be used when 
the value of this fieldjs requested. 

0x00 

Neither. Toolbar control is not applicable when the application is in either OLE host mode 
or OLE server mode. 

0x01 

Server. Toolbar control is applicable when the application is in OLE server mode. (This is 
the default value used by custom toolbar controls.) 

0x02 

Host. Toolbar control is applicable when the application is in OLE host mode. 

/ 

Both. Toolbar control is applicable when the application is in OLE server mode and OLE 
host mode. 


lyte): Signed integer that specifies how the toolbar control will be used during OLE 
menu merging. This field is only used by toolbar controls of type Popup. The value MUST be in 
the following table. 
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Value 

Meaning 

OxFFFF 

None. Toolbar control will not be placed in any OLE menu group. 

0x0000 

File. Toolbar control will be placed in the File OLE menu group. 

0x0001 

Edit. Toolbar control will be placed in the Edit OLE menu group. 

0x0002 

Container. Toolbar control will be placed in the Container OLE menu group. 

0x0003 

Object. Toolbar control will be placed in the Object OLE menu group. 

0x0004 

Window. Toolbar control will be placed in the Window OLE menu group. 

0x0005 

Help. Toolbar control will be placed in the Help OLE menu group. 


2.3.1.17 TBCBSpecific 

Contains information specific to button and ExpandingGrid type toolbar controls. 


01234567 


B33 


iconMask (variable) 


iBtnFace (optional) 


wstrAcc (variable) 




bFlags (1 byte): Structure of type TBCBSFIaqs section 2.3.1.18) that specifies which fields of 
this structure are saved to the file. 

icon (variable): Structure of type TBCBitmap (section 2.3.1.1) that specifies the icon data for 
this toolbar control. MUST exist if bFlags.fCustomBitmap equals 1. MUST NOT exist if 

bFlags.fCustomBitmap equals 0. 

iconMask (variable): Structure of type TBCBitmap (section 2.3.1.1) that specifies the icon data 
mask for this toolbar control. MUST exist if bFlags.fCustomBitmap equals 1. MUST NOT 
exist if bFlags.fCustomBitmap equals 0. The value of the biBitCount field of the 
BITMAPINFO HEADER (section 2.3. 1.2) contained by this TBCBitmap MUST be 0x01. The 
iconMask is used to specify the transparency of the icon. The iconMask is white in all the 
areas in which the icon is displayed as transparent and is black in all other areas. 

iBtnFace (2 bytes): Unsigned integer that specifies the icon of the toolbar control. When this 
value is set, the toolbar control will use the icon of the toolbar control whose toolbar control 
identifier (TCID) equals this value. MUST exist if bFlags.fCustomBtnFace equals 1. MUST 
NOT exist if bFlags.fCustomBtnFace equals 0. 
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wstrAcc (variable): Structure of type WStrinq (section 2.3.1. 4 ) that specifies the accelerator 
keys for this toolbar control. MUST exist if bFlags.fAccelerator equals 1. MUST NOT exist if 

bFlags.fAccelerator equals 0. 


2.3.1.18 TBCBSFIags 

Referenced by: TBCBSpecific 

Contains flags for Button and ExpandingGrid type toolbar controls. The bit description begins from 
the least significant bit. 


A - state (2 bits): Unsigned integer that specifies the toolbar control state. The value MUST be 
in the following table. 


Value (value of bits in parenthesis) 

Meaning 

0x00 (00) 

Button is up. 

0x01 (01) 

^Kitton is do^mpushed). 

0x03 (11) 

iMton is in mixed state. 


B - fAccelerator (1 bit): A bit that specifies whether the wstrAcc field of the TBCBSpecific 
structure (section 2.3.1.17) that contains this structure has been saved to the file. A value of 
1 specifies that the wstrAcc field of the TBCBSpecific structure (section 2.3.1.17 ) that 
contains this structure MUST exist. If the value equals 1, the value of the fSaveUIStrings 
field of the TBCS Flags structure (section 2.3.1.12) contained by the TBCHeader structure 
(section 2.3.1.10 ) contained by the structure that contains the TBCData structure (section 
2.3.1.13) that contains the TBCBSpecific structure (section 2.3.1.17 ) that contains this 
structure MUST be 1. 

C - fCustomBitmap (1 bit): A bit that specifies whether the toolbar control has a custom icon. 
A value of 1 specifies that the icon and iconMask fields of the TBCBSpecific structure that 
contains this structure MUST exist. 

D - fCustomBtnFace (1 bit): A bit that specifies whether the toolbar control is using an 
alternate icon as its own. A value of 1 specifies that the iBtnFace field of the TBCBSpecific 
structure that contains this structure MUST exist. 


: that c 

inkTyi 




- fHyperlinkType (2 bits): Unsigned integer that specifies the type of hyperlink associated 
iar control. The value MUST be in the following table. 


Value (value of bits ir 
parenthesis) 


Hyperlink type 


No hyperlink. This toolbar control does not have a hyperlink. 
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Value (value of bits in 
parenthesis) 

Hyperlink type 

0x02 (10) 

Image link. The hyperlink links to an image file. 


F - reservedl (1 bit): Reserved bit. SH0ULD <12> be 1. 

2.3.1.19 TBCComboDropdownSpecific 

Contains information specific to Edit, ComboBox, GraphicCombo, DropDown, SplitDropDown, and 
GraphicDropDown type toolbar controls. 


0 

1 

2 

3 

4 

5 
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7 

8 
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0 
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data (variable) 















data (variable): Structure of type TBCCDData (section 2.3.1.20) . MUST exist if the toolbar 
control identifier (TCID) (the tcid field of the TBCHeader structure (section 2.3.1.10) 
contained by the structure that contains the TBCData structure (section 2.3.1.13 ) that 
contains this structure) equals 0x0001. MUST NOT exist if the TCID does not equal 0x0001. 

2.3.1.20 TBCCDData 

Referenced by: TBCComboDropdownSpecific 


Contains information specific to Edit, ComboBox, GraphicCombo, DropDown, SplitDropDown, and 
GraphicDropDown type toolbar controls. 
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wstrList (variable): Zero-based index array of WStrinq structures (section 2. 3. 1.4 ). The 
number of elements MUST be equal to cwstrltems. Contains the list of strings that are 
dropped by this toolbar control. 


cwstrMRU (2 bytes): Signed integer that specifies the number of most recently used strings. 
MUST be equal to OxFFFF (-1) or greater than or equal to 0x0000. A value of OxFFFF (-1) 
means that there are no most recently used strings. 

iSel (2 bytes): Signed integer that specifies the zero-based index of the selected item in the 
wstrList field. MUST be equal to OxFFFF (-1) or greater than or equal to 0x0000. A value of 
OxFFFF (-1) means that there is no selected item. MUST be less than the cwstrltems value. 

cLines (2 bytes): Signed integer that specifies the suggested number of lines that tl 
control will display at any time when displaying the elements of wstrList. A value! 
means that the toolbar control will size itself according to the number of items. I 
or greater than 0x0000. 

dxWidth (2 bytes): Signed integer that specifies the width in pixels that t 
drop-down has. This excludes the width of the toolbar control border a 
equal to OxFFFF (-1) or greater than or equal to 0x0000. A value ofjP 
width to accommodate all the strings in wstrList. 

wstrEdit (variable): Structure of type WString (section 2.3.1 
of the ComboBox toolbar control. 



2.3.1.21 TBCMenuSpecific 


Contains information specific to Popup, ButtonPopui 
SplitButtonMRUPopup type toolbar controls. 


tbid (4 bytes): Signed integer that specifies the toolbar ID of the toolbar that the toolbar control 
drops. MUST be greater than or equal to 0x00000000. A value of 0x00000000 means that the 
toolbar control does not drop a toolbar. A value of 0x00000001 means that the toolbar control 
drops a custom toolbar. A valde greater than 0x00000001 means that the toolbar control 
drops a built-ii^toolbar./tgee rMS-CTDOCl section 2.1 and rMS-CTXLSl section 2.1 for a list of 
toolbar identifiers associated with built-in toolbars. 

name (variable): Structure of type WStrinq (section 2.3.1.4) . Name of the custom toolbar that 
the toolbar control drops. MUST exist if tbid equals 0x00000001. MUST NOT exist if tbid is 
not equal to 0x00000001. 

Visual Basic for Applications Digital Signature Storage 

ifies the format of the digital signature for Visual Basic for Applications (VBA) projects. 
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2. 3. 2.1 DigSiglnfoSerialized 


Referenced by: DiaSiaBlob. WordSiaBlob 
Specifies the detailed data of a VBA digital signature. 



ijectNameBuffer (variable) 


rgchTimestampBuffer (variable) 



F bSignature (4 bytes): An unsigned integer that specifies the size of the pbSignatureBuffer 
field ii 

signatureOffset (4 bytes): An unsigned integer that specifies the offset of the 

pbSignatureBuffer field relative to the beginning of this structure's parent DigSigBlob 
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(section 2. 3. 2.2 ); or if the parent is a WordSigBlob (section 2. 3.2.3) . the offset is relative to 
the beginning of the parent's cbSiglnfo field. 

cbSigningCertStore (4 bytes): An unsigned integer that specifies the size of the 

pbSigningCertStoreBuffer field in bytes. 

certStoreOffset (4 bytes): An unsigned integer that specifies the offset of the 

pbSigningCertStoreBuffer field relative to the start of this structure's parent DigSigBlob 
(section 2. 3. 2. 2 ): or if the parent is a WordSigBlob (section 2. 3. 2. 3) . the offset is relative to 
the start of the parent's cbSiglnfo field. 

cbProjectName (4 bytes): An unsigned integer that specifies the count in bytes of the^^ 
rgchProjectNameBuffer field, not including the null-terminating character. MUST be 
0x00000000. 

projectNameOffset (4 bytes): An unsigned integer that specifies the offset of the 

rgchProjectNameBuffer field relative to the beginning of this structure's parent DigSigBlob 
(section 2. 3. 2.2 ): or if the parent is a WordSigBlob (section 2. 3.2.3) . the offset is relative to 
the beginning of the parent's cbSiglnfo field. 

fTimestamp (4 bytes): This field is reserved and MUST be 0x00000000. 

cbTimestampUrl (4 bytes): An unsigned integer that specifies the count in bytes of the 
rgchTimestampBuffer field, not including the null-terminating character. MUST be 
0x00000000. 

timestampUrlOffset (4 bytes): An unsigned integer that specifies the offset of the 

rgchTimestampBuffer field relative to the beginning of this structure's parent DigSigBlob 
(section 2.3.2.2) ; or if the parent is a WordSigBlob (section 2.3.2. 3) . the offset is relative to 
the beginning of the parent's cbSiglnfo field. 

pbSignatureBuffer (variable): An array of bytes that specifies the VBA Digital Signature 
(section 2. 3. 2. 4) of the VBA project. 

pbSigningCertStoreBuffer (variable): A VBASiqSerializedCertStore structure (section 

2. 3. 2. 5. 5 ) containing the publie digital certificate information of the certificate used to create 
the digital signature^^ 

rgchProjectNameBuffer (variable): A null-terminated array of Unicode characters. The field is 
reserved and MUST be a single null Unicode character (0x0000). 

rgchTimestampBuffer (variable): A null-terminated array of Unicode characters. The field is 
reserved and MUST be a single null Unicode character (0x0000). 

2.3. 2.2 DigSigBlob 

Referenced by: VtDiaSiaValue 

Specifies the layout of the VBA digital signature data. 

| | | | | | | | | | M | I I I I I I I H I I I I I I I I hi | 

0|l|2|3|4|5|6|7|8|9|0|l|2|3|4|5|6|7|8|9|0|l|2|3|4|5|6|7|8|9|0|l 

cb 
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serialized Pointer 


signaturelnfo (variable) 


padding (variable) 






cb (4 bytes): An unsigned integer that specifies the size of the signaturelnfo and padding 
fields combined, in bytes. 

serializedPointer (4 bytes): An unsigned integer that specifies the offset of the signaturelnfo 
field within this structure. MUST be 0x00000008. 

signaturelnfo (variable): A DiqSiqlnfoSerialized structure (section 2. 3. 2.1) containing the data 
for the signature. 

padding (variable): An array of bytes. The size of this array is the number of bytes necessary 
to pad the size of the signaturelnfo field to a multiple of 4 bytes. The contents of this field 
are undefined and MUST be ignored. 

2. 3. 2. 3 WordSigBlob 

Specifies the layout of the VBA digital signature da 
Unicode character string. 




cch (2 bytes): An unsigned integer that specifies half the count of bytes of the remainder of the 
jcture. MUST be the value given by the following formula. 

l = (cbSiglnfo + (cbSiglnfo mod 2) + 8) / 2 

cbSiglnfo (4 bytes): An unsigned integer that specifies the size of the signaturelnfo field in 
bytes. 
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serializedPointer (4 bytes): An unsigned integer that specifies the offset of the signaturelnfo 
field within this structure relative to the cbSiglnfo field. MUST be 0x00000008. 

signaturelnfo (variable): A DiqSiqlnfoSerialized structure (section 2. 3.2.1) containing the data 
for the signature. 

padding (variable): An array of bytes. The size of this array is the number of bytes necessary 
to pad the entire structure's size to a multiple of 2 bytes. The contents of this field ar° 
undefined and MUST be ignored. 

2. 3. 2. 4 VBA Digital Signature 

The VBA digital signature MUST be a PKCS #7 SignedData (£PKCSZ1 section 9.1) structuri 
constrained as specified in the following sections. The following section uses ASN.l notatior 
(riTUX680- 19941) to specify the data format where applicable. 

2. 3. 2. 4.1 SignedData Constraints 

The SignedData structure (IPKCSZl section 9.1) specifying the digital signature MUST conform to 
the following constraints: 

■ The digestAlgorithms field MUST contain only one digestAlgorithmldentifier ( TPI 
section 6.3), and that digestAlgorithmldentifier MUST specify the identifier of the algorithm 
used to create the digest of the siqnature. <13> 

■ The contentlnfo field's contentType MUST be an Object Identifier ( riTUX680-19941 section 
3.8.35) with the value "1.3.6.1.4.1.311.2.1.4". The content field of the contentlnfo of this 
SignedData structure MUST be a SpcIndirectDataContent structure (section 2. 3. 2. 4. 3.1 ). 

■ The certificates field MUST contain certificates as specified by rPKCS71 section 9.1. This MUST 
include the signature verification certificate and MAY contain any intermediate certificates 
between that end entity and the root, including the root. If the SignedData contains a 
Countersignature (rPKCS91 section 6.6), the certificates associated with the 
Countersignature also MUST be contained in the certificates field. 

■ The crls field SHOULD be absent. If present, the crls field MUST be ignored. 

■ The signerlnfos field MUST contain a single Siqnerlnfo structure (section 2.3. 2. 4. 2) (£PKCSZI 
section 9.2). 

2. 3. 2. 4. 2 Signerlnfo Constraints 

The Signerlnfo in the SignedData structure (section 2. 3.2.4. 1 ) MUST conform to the following 
constraints: 

■ The authenticatedAttributes (section 2. 3. 2. 4. 4) field MUST be present. 

■ This field MUST contain the following attributes: 

■ A content-type attribute with its value set as specified in rPKCS71 section 9.2. 



message-digest attribute with its value set as specified in rPKCS71 section 9.2. 


is field MAY also contain: 


ne SpcStatementType attribute (section 2. 3.2.4. 4.1 ). but this attribute MUST be ignored. 
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■One SpcSpOpusInfo attribute (section 2.3.2.4.4.2 V 


If the signature has been timestamped, then the unauthenticatedAttributes field (section 
2. 3. 2. 4. 5 ! MUST be present and MUST contain a single Countersignature attribute ( rPKCS91 
section 6.6). If the signature has not been timestamped, the unauthenticatedAttributes field 
MUST be absent. 


2. 3. 2. 4. 3 SignedData contentlnfo Structures 

The contentlnfo field of the SignedData structure (section 2.3.2.4.1) MUST be a 
SpcIndirectDataContent structure (section 2. 3. 2. 4. 3.1 ) formatted as specified in the f 0 "- • : -- 
section. 

2. 3. 2. 4. 3.1 SpcIndirectDataContent 

This structure specifies data about the digital signature and contains the hash of the L 
be signed. This structure is specified by the following ASN.l ( ITTUX680-1994P notatio 

SpcIndirectDataContent : := SEQUENCE { 

data SpcAttributeTypeAndOpt: 

messageDigest Digestlnfo 


SpcAttributeTypeAndOptionalValue : := SEQUENCE { 
type OBJECT IDENTIFIER, 

value [0] EXPLICIT ANY OPTld^^ 


Digestlnfo : := SEQUENCE { 


Algorithmldenti f 
parameters 


: = SEQUENCE 
OBJECT IDEN 

expl; 


4 ' 


The SpcIndirectDataContent structure's' 
kttribul 



ields MUST be constrained as follows: 

The data field MUST be a SpcAttributeTypeAndOptionalValue structure. 

■ The messageDigest field MUST be a Digestlnfo structure. 

The SpcAttributeTypeAndOptionalValue structure fields MUST be constrained as follows: 

■ The type field MUST be an Object Identifier f riTUX680-19941 section 3.8.35) with the value 
1.3.6.1.4.1.311,2.1.29. 

■ The value field SHOULD be set to a zero byte OCTETSTRING ( ITTUX680-19941 section 20). If 
the field has any data associated with it, the data MUST be ignored. 

The Digestlnfo structure's fields MUST be constrained as follows: 

■ The digestAlgorithm field MUST be an Algorithmldentifier structure. The algorithm field of 
digestAlgorithm specifies the Object Identifier ( ITTUX680-19941 section 3.8.35) of the digest 
algorithm that was used to hash the VBA project contents, producing the value for the digest 
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field. This Object Identifier ( riTUX680-19941 section 3.8.35) value MUST be set to the same 
algorithm identifier as specified in the digestAlgorithm field of the SiqnedData structure 
(section 2. 3. 2. 4.1) . The parameters field of digestAlgorithm MUST be set to the Null type 
( ITTUX680-19941 section 6.2) with a length of zero. 

The digest field MUST be an OCTETSTRING (ITTUX680- 19941 section 20). The value of the 
OCTETSTRING MUST be produced by means of the hash algorithm specified in rMS-OVBAl 
section 2.4.2. 


2. 3. 2. 4. 4 Signerlnfo authenticatedAttributes Structures 

This section specifies the attribute data that is stored in the authenticatedAttributes field of the 
Signerlnfo structure (section 2. 3. 2. 4. 2 ). 

2. 3. 2. 4. 4.1 SpcStatementType 

This structure is specified by the following ASN.l ( ITTUX680-1994P notation. 

SpcStatementType : := SEQUENCE of OBJECT IDENTIFIER 

The SpcStatementType MUST contain one Object Identifier ( 

with either the value 1.3.6.1.4.1.311.2.1.21 or 1.3.6.1.4.1.311.2.1.22. The S| 

MUST be ignored. 

2. 3. 2. 4. 4. 2 SpcSpOpusInfo 

This structure is specified by the following ASN.l ( riTli 

SpcSpOpusInfo ::= SEQUENCE { 

programName [0] EXPLICIT SpcSI 

morelnfo [1] EXPLICIT SpcL: 



The programName field MUST be set to a SpcStrinq structure (section 2.3.2. 4. 4. 3 ). The value of 
the string contained in this structure specifies the description of the project for which the signature 
was created. The Unicode field within the SpcString programName SHOULD have a value that is a 
0 length BMPSTRING ( ITTUX680-19941 section 34.12). A value other than an empty string 
MAY <14> be provided. 

The morelnfo field MAY be absent. If present, it MUST be set to a SpcLink structure (section 
2.3.2.4.4.4) . If present the value of the url field within the SpcLink structure specifies a Uniform 
Resource Locator (URL) to associate with the signature. <15> 

2. 3. 2. 4. 4. 3 SpcString 

This structure is specified by the following ASN.l ( ITTUX680-1994P notation. 


o 

The u 


he Unicode field MUST be of the BMPSTRING ( ITTUX680- 19941 section 34.12) type. 
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2. 3. 2. 4. 4. 4 SpcLink 

This structure is specified by the following ASN.l ( nTUX680-1994D notation. 


SpcLink 


CHOICE 


[0] IMPLICIT IA5 STRING 


The url field MUST be of the IA5STRING ( ITTUX680-19941 section 34.1) type. The structure 
specifies a hyperlink resource by using the Uniform Resource Locator (URL). 

2. 3. 2. 4. 5 Signerlnfo unauthenticatedAttributes 

A Countersignature located in the Signerlnfo (section 2.3.2. 4. 2) unauthenticatedAttributes 

field SHOULD be generated by a trusted third-party time stamp authority (TSA). Its purpose is to 
assert that the VBA project signature existed prior to the time specified in the SigningTime 
attribute, specified in the following attributes. 



The Countersignature used MUST consist of the following attributes in 

unauthenticatedAttributes field: 


■ ContentType (IPKCS9I section 6.3): The attribute's value MUST be set to PKCS #7 Data 
(IPKCS7I section 8). 

■ SigningTime ( rPKCS91 section 6.5): The value MUST be set as specifia^y rPKCS91 section 6.5. 


■ messageDigest ( TPKCS91 section 6.4): The value MUST be set as specified by rPKCS91 section 

6.6. 


In addition, the certificate (£RFC3280J) whose private key signed the Countersignature MUST be 
added to the SiqnedData (section 2. 3. 2. 4.1) certificates field. Intermediate and root certificates of 
the certificate chain, including the signing certificate, MAY also be added to the SignedData (section 
2.3. 2.4.1 ) certificates field. 

2. 3. 2. 4. 6 VBA Digital Signature Verification 

The VBA signature verification employs the steps specified in the following sections. The SiqnedData 
(section 2.3.2.4) integrity is verified as specified in PKCS #7 (JTKCSZI section 9.3 and rPKCS71 
section 9.4). 

2. 3. 2. 4. 6.1 Certificate Processing 

The software publisher's signing certificate and certificate chain MUST be verified against the 
following criteria: 

■ be validated to a trusted root certificate by using X.509 path 



by l~RFC32801 section 6. 


Either the signing certificate MUST contain the extended key usage (EKU) (£RFC3280J section 
.2.1. value for code signing (1.3. 6. 1.5. 5. 7. 3. 3) or there MUST be no EKU fields present in 


he certificate chain MUST be within its validity period. If the certificate chain is not within its 
validity period, the signature MUST have a timestamp, and that timestamp MUST be validated 
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according to the Timestamp Processing rules (section 2. 3. 2. 4. 6 . 2) . If the signature has a 
timestamp, the certificate chain MUST be within its validity period at the timestamp time. 

If any of these conditions are not met, the signature MUST be treated as invalid. 

2. 3. 2. 4. 6. 2 Timestamp Processing 

A signature with a timestamp Countersignature MUST be considered valid if, and only if, it meets 

the following criteria: 

■ The certificate chain for the Countersignature MUST be built according to a trusted root 
certificate by using X.509 path validation rules as specified by rRFC32801 section 6. 

■ The time stamp authority (TSA) certificate that was used to sign the timestamp MUST contain 
EKU value for timestamping ("1.3.6. 1.5. 5. 7. 3. 8"). 

2. 3. 2. 5 Serialized Certificate Store Structure 

This section specifies the structures used for storing a digital certificate, and optionally a list of 

properties, in a serialized representation as part of the digital signature for a VBA project. 

2. 3. 2. 5.1 SerializedCertificateEntry 

Referenced by: CertStoreCertificateGrouo 

Specifies a serialized digital certificate entry in a serialized digital certificate store. 
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tificate (variable) 












\\v 


id (4 bytes): An unsigned integer. MUST be 0x00000020. 

encodingType (4 bytes): An unsigned integer that MUST be the value 0x00000001, which 
specifies ASN.l encodij#( ITTUX680-19941) . 

length (4 bytes): An unsigned integer that specifies the count of bytes for the certificate field. 

certificate (variable): Specifies the certificate data. MUST contain the ASN.l ITTUX680-19941 
DER encoding of an X.509 certificate as specified by rRFC32801 . 

2. 3. 2. 5. 2 EndElementMarkerEntry 

Referenced by: DocSigSerializedCertStore, VBASigSerializedCertStore 

56 / 205 

[MS-OSHARED] - V20120122 
Office Common Data Types and Objects Structures 

Copyright © 2012 Microsoft Corporation. 

Release: Sunday, January 22, 2012 


Specifies a special entry in a serialized digital certificate store that marks the end of the store. 


l 2 3 

01234567890123456789012345678901 


id 


marker 


id (4 bytes): An unsigned integer. MUST be 0x00000000. 

marker (8 bytes): A sentinel value 8 bytes in length, the value of which MUST be 
0x0000000000000000. 



equal to OxOOOOFFFF and MUST NOT be the value 0x00000000 or 0x00000020 because these 
values specify the special entries SerializedCertificateEntrv (section 2.3.2.5.1) and 
EndElementMarkerEntrv (section 2. 3. 2. 5. 2 ). 

encodingType (4 bytes): An unsigned integer that MUST be the value 0x00000001, which 
specifies ASN.l encoding ( riTUX680-19941) . 

length (4 bytes): An unsigned integer that specifies the count of bytes for the value field. 

lue (variable): Specifies the value of the property. This field SFIOULD be ignored on 
read ! G> . 
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2. 3. 2. 5. 4 CertStoreCertificateGroup 


Referenced by: DocSiaSerializedCertStore, VBASigSerializedCertStore 

Specifies a grouping of elements in a serialized digital certificate store that consists of zero or more 
properties of a certificate, and the serialized certificate itself. 


l 2 3 i 

01234567890123456789012345678901 


elementList (variable) 


certificateElement (variable) 


elementList (variable): An array of Serialized PropertvEntrv (section 2. 3. 2.5. 3 ). This array can 
contain zero or more elements. Elements of this array are read and processed un|ii a 
SerializedPropertyEntry.id is read with the unsigned integer value 0x00000020, which 
specifies the end of this array and the beginning of the certificateElement field. The 
terminating SerializedPropertyEntry.id that is read is actually the certificateElement.id 
field and not a part of this field. 
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version (4 bytes): An unsigned integer identifying the version of the structure. MUST be 
0x00000000. 

fileType (4 bytes): An unsigned integer that MUST be the value 0x54524543. This value 
specifies that the structure is a digital certificate store. 

certGroup (variable): A CertStoreCertificateGroup (section 2. 3. 2. 5. 4 ) structure that specifies 
the digital certificate stored in this serialized digital certificate store along with a set of 
optional properties. 

endMarkerElement (12 bytes): An EndElementMarkerEntrv (section 2.3.2.5.2) structure 
specifying the end of the structure. 

2.3.3 Property Set Storage 

An OLE property set storage is a format as specified in rMS-OLEPSl that specifies how to store a 
collection of sets of properties. This section specifies the property sets and data formats used within 
them that are applicable to this specification. The Summary Information (section 2. 3. 3. 2.1) property 
set SHOULD be written < 17 > . The Document Summary Information (section 2. 3. 3. 2. 2) and User 
Defined (section 2.3.3.2.3) property sets are optional. 

2.3.3. 1 Property Types 



This section specifies the data format for property data 
specification than what is provided in rMS-OLEPSl . 


2. 3. 3. 1.1 PropertySetSystemldentifier 

Specifies an operating system type and version for a pWi 


OSMajorVersion (1 byte): An unsigned integer specifying the major version number of the 
operating system that wrote the property set. 

OSMinorVersion (1 byte): An unsigned integer specifying the minor version number of the 
operating system that wrote the property set. 

OSType (2 bytes): An unsigned integer that MUST be 0x0002. 

2. 3. 3. 1.2 VtThumbnailValue 

VtThumbnail 

Specifies data for the thumbnail property. This type conforms to the ClipboardData type as 
specified in rMS-OLEPSl section 2.11, but this section specifies additional detail applicable to this 
type. 
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1 2 3 

01234567890123456789012345678901 


cb 


cftag 


formatld (optional) 


cfDataBytes (variable) 


padding (variable) 


cb (4 bytes): An unsigned integer that specifies the count of bytes of the remainder of the 
structure, not including any padding field bytes. 

cftag (4 bytes): An unsigned integer specifying the clipboard format of the data. MUST be 
0x00000000, CF_WINDOWS (OxFFFFFFFF), or CF_MACINTOSH (OxFFFFFFFE). A value of 
0x00000000 specifies that there is no image data associated with the property. 

formatld (4 bytes): An unsigned integer specifying the format of the data stored in the 
cfDataBytes field. MUST NOT exist if the cftag field is 0x00000000. MUST exist if cftag is 
not 0x00000000. If it exists, it MUST be one of the following: CF_METAFILEPICT 
(0x00000003), CF_ENH METAFILE (OxOOOOOOOE), or CF_JPEG (0x00000333). 

cfDataBytes (variable): An array of bytes containing the data for the thumbnail image. MUST 
NOT exist if the cftag field is 0x00000000. MUST exist if cftag is not 0x00000000. If it exists, 
MUST be (cb - 8) bytes in length. The format of the data is specified by formatld according 
to the following table. 


formatld Value 

Data format 

CF_METAFILEPICT (0x00000003) 

A METAFILEPICT structure as specified bv TMS-WMF1. 

CF ENH METAFILE (OxOOOOOOOE) 

Enhanced metafile imaae data as specified in TMS-EMF1. 

CF_JPEG (0x00000333) 

Joint Photographic Experts Group (JPEG) image data. 


padding (variable): An array of bytes. The length of the array MUST be the smallest number of 
bytes required to pad the size of this structure to a multiple of 4 bytes. The padding SHOULD 
be 0x00 values, but MAY be undefined values, and MUST be ignored. 

2. 3. 3. 1.3 VtThumbnail 

Specifies the format for the thumbnail property. This type conforms to the VT_CF 
TypedPropertyValue type as specified in MS-OLEPS1 section 2.15, but is presented in additional 
detail here to specify specific constraints on the type of data that can be contained in this type. 
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vtValue (variable) 



wType (2 bytes): An unsigned integer that MUST be VT_CF (0x0047). 
padding (2 bytes): An unsigned integer that MUST be 0x0000. MUST be ignore 
vtValue (variable): MUST be a VtThumbnailValue (section 2. 3. 3. 1.2 ) structure. 

2.3. 3.1.4 Lpstr 

Referenced by: VtStrina 

Specifies data for a null-terminated single-byte character string, the encoding of which corresponds 
to the value of the enclosing property set's CodePage property ( rMS-OLEPSI section 2.18.2). This 
type deviates from the CodePageString type specified in _Ol EPpt section 2.5 in the way that 
the cch field can be calculated and in the limit to the length af |he string. 
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padding (variable) 


cch (4 bytes): An unsigned integer specifying the number of single-byte characters in the value 
field. SHOULD be less than or equal to 0x0000FFFF. <18> SHOULD specify the number of 
characters in the value field including the terminating NULL character but not including 
padding. MAY specify the number of characters in both the value and padding fields. <19> 

value (variable): A null-terminated array of single-byte characters defining the string. 

padding (variable): An array of bytes. The length of the array MUST be the smallest number of 
bytes required to pad the size of the value field to a multiple of 4 bytes. The padding SHOULD 
be 0x00 values, but MAY be undefined values, and MUST be ignored . <20> 

1.3. 1.5 UnalignedLpstr 

'eferenced by: VtUnalianedStrina. VtVecUnalianedLostrValue 
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Specifies data for a null-terminated single-byte character string, the encoding of which corresponds 
to the value of the enclosing property set's CodePage property ( TMS-OLEPS1 section 2.18.2). This 
type deviates from the CodePageString type specified in rMS-OLEPSl section 2.5 in the absence of 
padding bytes and in the limit to the length of the string. 


01234567 


901234567 


901234567 


cch (4 bytes): An unsigned integer specifying the number of single-byte characters in the value 
field. SHOULD be less than or equal to 0x0000FFFF. <21> 

value (variable): A null-terminated array of single-byte characters defining the string. 

2.3.3. 1.6 Lpwstr 

Referenced by: VtHvoerlink. VtStrina. VtUnalianedStrina, VtVecLpwstrValue 

Specifies data for a null-terminated Unicode character string. This type deviates from the 
UnicodeString type specified in rMS-OLEPSl section 2J in the limit to the length of the string and 
in the way the length is specified in characters and not bytes. 
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padding (variable) 


cch ( A es): An unsigned integer specifying the number of Unicode characters written as the 
val eld including the terminating NULL character. SHOULD be less than or equal to 

Jle): A null-terminated array of Unicode characters defining the string. 



•adding (variable): An array of bytes. The length of the array MUST be the smallest number of 
bytes required to pad the size of the value field to a multiple of 4 bytes. The padding SHOULD 
be 0x00 values, but MAY be undefined values, and MUST be ignored. <23_> 
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2.3. 3.1. 7 VtVecLpwstrValue 

Referenced by: VtVecLpwstr 


Specifies data for a property containing an array of Unicode strings. This type conforms to the 
(VT_VECTOR | VT_LPWSTR) TypedPropertyValue value format as specified in rMS-OLEPSl section 
2.15, except that the sequence of string structures following the cElements field are of type Lpwstr 
(section 2. 3. 3. 1.6) . 
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rgString (variable) 



cElements (4 bytes): An unsigned integer specifying the number of elemei 

rgString (variable): An array of Lpwstr (section 2. 3.3.1. 6 ). Specifies the li 
property. 


tring. 

lues for the 


2. 3. 3. 1.8 VtVecLpwstr 

Specifies the format of a property for which the value is a 
to the (VT_VECTOR | VT_LPWSTR) TypedPropertyValm 
2.15, except that the format of the strings it contains is a 


t of Unicode strings. This type conforms 
'pe as specified in rMS-OLEPSl section 
pecified in this specification. 


ffl 


ur 


01234567 


vtValue (variable) 


wType (2 bytes): An unsigned integer that MUST be equal to VT_VECTOR | VT_LPWSTR 
(OxlOlF). 

padding (2 bytes): An unsigned integer that MUST be 0x0000. MUST be ignored. 
vtValue (variable): MUST be a VtVecLpwstrValue (section 2.3.3. 1.7) structure. 

2.3.3. 1.9 VtVecUnalignedLpstrValue 

Referenced by: VtVecUnalianedLpstr 

Specifies data for a property containing an array of single-byte character strings. This type conforms 
to the (VT_VECTOR | VT_LPSTR) TypedPropertyValue value format as specified in rMS-OLEPSl 
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section 2.15, except that the sequence of string structures following the cElements field are of type 
UnaliqnedLpstr (section 2.3.3.1.5) . 


901234567 


901234567 


rgString (variable) 


cElements (4 bytes): An unsigned integer specifying the number of elements in rgString. 

rgString (variable): An array of UnalignedLpstr (section 2.3.3.1.5 ). Specifies the list of values 
for the property. 

2.3.3.1.10 VtVecUnalignedLpstr 

Specifies the format of a property for which the value is a list of single-byte character strings. This 
type conforms to the (VT_VECTOR | VT_LPSTR) TypedPropertyValue type as specified in fMS- 
OLEPS1 section 2.15, except that the format of the strings it contains is as specified in this 
specification. 




9 0 1 2 3 4 5 


vtValue (variable) 


wType (2 bytes): An unsigned integer that MUST be VT_VECTOR | VT_LPSTR (OxlOlE). 
padding (2 bytes): An unsigned integer that MUST be 0x0000. MUST be ignored. 
vtValue (variable): MUST be a VtVecUnaliqnedLpstrValue (section 2. 3. 3. 1.9 ) structure. 

2.3.3.1.11 VtString 

Specifies the format of a property for which the value is a string. 




stringValue (variable) 
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stringType (2 bytes): An unsigned integer that MUST be VT_LPSTR (OxOOlE) or VT_LPWSTR 
(OxOOlF). 

padding (2 bytes): An unsigned integer that MUST be OxOOOO. MUST be ignored. 

stringValue (variable): A structure that determines its type depending on the value of the 
stringType field according to the following table. 


stringType 

stringValue type 

VT_LPSTR (OxOOlE) 

LDStr (section 2.3.3.1.41 

VT_LPWSTR (OxOOlF) 

LDWstr (section 2.3.3.1.61 


2.3.3.1.12 VtUnalignedString 

Referenced by: VtHeadinaPair 

Specifies the format of a property for which the value is a string but where the stringValue field is 
not padded to any particular length if it is a single-byte character string type. 


m 


9 0 1 2 3 4 5 


67 


stringValue (variable) 


stringType (2 bytes): An unsigned integer that MUST be VT_LPSTR (OxOOlE) or VT_LPWSTR 
(OxOOlF). 

padding (2 bytes): An unsigned integer that MUST be 0x0000. MUST be ignored. 

stringValue (variable): A structure that determines its type depending on the value of the 
stringType field according to the following table. 


stringT 

- > > 

stringValue type 

VT_LPSTR (OxOOlE) 

UnalianedLDStr (section 2.3.3.1.51 

VT_LPWSTR (OxOOlF) 

Lpwstr (section 2.3.3. 1.61 


2.3.3.1.13 VtHeadingPair 

R^m-enced^^ VtVecHeadingPairValue 
Specifies data for a heading pair for a property. 
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012345678901 2|3|4|5|6|7|8|S 
headingstring (variable) 


headingstring (variable): A structure of type VtUnaliqnedStrinq (section 2.3.3 
the header string. 


headerParts (8 bytes): A VT_I4 TypedPropertyValue structure as specified in £ 
section 2.15. The Value field of the TypedPropertyValue structure specifies th 
document parts associated with this header. 

2.3.3.1.14 VtVecHeadingPairValue 

Referenced by: VtVecHeadinaPair 

Specifies data for the heading pair property. This type confc 
TypedPropertyValue value format as specified in rMS-OLI 
specifies additional detail specifically applicable to this 



rgHeadingPai 

fcs (variable) 

■■ 

▼ 


cElements (4 bytes): An unsigned integer specifying the count of elements in the 

rgHeadingPairs field. The number of elements in rgHeadingPairs MUST be half of this 
value. This value MUST be even. 


rgHeadingPairs (variable): An array of VtHeadinqPaii 

heading pairs for the property. 


2.3.3.1.15 VtVecHeadingPair 


(section 2.3.3.1.13) . Specifies the list of 


Specifies the format for a property representing the headers corresponding to the 
GKPIDDSI DOCPARTS property data (section 2. 3. 3. 2. 2.1 ). This type conforms to the (VT_VECTOR | 
VT_VARIANT) TypedPropertyValue type as specified in rMS-OLEPSl section 2.15, but is presented 
in additional detail here to specify specific constraints on the type and format of data that can be 
contained in this type. 
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Refer to the GKPIDDSIJHEADINGPAIR (section 2.3.3. 2. 2.1 ) and GKPIDDSI_DOCPARTS (section 
2.3. 3. 2.2.1) properties for additional details. 



2.3.3.1.16 VtDigSigValue 

Referenced by: VtDiaSia 

Specifies the data for a VBA digital signature property. This t^j 
TypedPropertyValue value format as specified in rMS-OLEI 
specifies additional detail applicable to this type. 
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vbaDigSig (variable) 


cb (4 bytes): An unsigned in®|er that specifies the size in bytes of vbaDigSig. MUST be equal 

to vbaDigSig. cb + 8. 

vbaDigSig (variable): A DiqSiqBlob (section 2. 3. 2. 2) structure that specifies a VBA digital 
signature. 


2.3.3.1.17 VtDigSig 

Specifies the format for a property representing a VBA digital signature. This type conforms to the 
VT_BLOB TypedPropertyValue type as specified in MS-OLEPS1 section 2.15, but is presented in 
additional detail here to further specify the content of the property. 




901234567 
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vtValue (variable) 


wType (2 bytes): An unsigned integer that MUST be equal to VT_BLOB (0x0041). 



[MS-OSHARED] - V20120122 
Office Common Data Types and Objects Structures 

Copyright © 2012 Microsoft Corporation. 

Release: Sunday, January 22, 2012 



dwApp (8 bytes): MUST be a VT_I4 TypedPropertyValue as specified in rMS-OLEPSl section 
2.15. The Value field of this structure is implementation specific. <25> 


dwOfficeArt (8 bytes): MUST be a VT_I4 TypedPropertyValue as specified in rMS-OLEPSl 
section 2.15. The Value field of this structure MUST be a MSOSPID type value ( rMS-ODRAWl 
section 2.1.2) specifying the identifier of the shape ( rMS-ODRAWl section 2.2.31) to which 
this hyperlink applies in the document. If this hyperlink does not apply to a shape, the Value 
field of this structure MUST be 0x00000000. 

dwlnfo (8 bytes): MUST be a VT_I4 TypedPropertyValue as specified in rMS-OLEPSl section 
2.15. The Value field of this structure is implementation specific. <26> The high-order 2-byte 
integer of the Value field of this structure SHOULD be 0x0000. <27> 

hlinkl (variable): MUST be a VtStrinq structure (section 2.3.3.1.11 ) with hlinkl.wType equ 
to VT_LPWSTR. hlinkl. stringValue specifies the hyperlink target. 

hlink2 (variable): MUST be a VtString structure (section 2.3.3.1.11) with hlink2.wType equal 
to VT_LPWSTR. hlink2. stringValue specifies the hyperlink location. 

2.3.3.1.19 VecVtHyperlink 

Referenced by: VtHvoerlinkValue 

Specifies the data format for an array of hyperlinks. This type conforms to the (VT_VECTOR | 
VT_VARIANT) TypedPropertyValue value format as specified in rMS-OLEPSl section 2.15, but this 
section specifies additional details specific to this type. 



my 


cElements 

rgHyperlink (variable) 


cElements (4 bytes): An unsigned integer specifying the count of elements in the rgHyperlink 
field. The number of elements in rgHyperlink MUST be 1/6 of this value. This value MUST be 
evenly divisible by 6. 

rgHyperlink (variable): An array of VtHyperlink (section 2.3.3.1.18 ). Specifies the list of 
hyperlinks for the property. 

2.3.3.1.20 VtHyperlinkValue 

Referenced by: VtHyperlinks 

Specifies the data for a hyperlinks property. This type conforms to the VT_BLOB 
TypedPropertyValue value format as specified in rMS-OLEPSl section 2.15, but this section 
specifies additional detail applicable to this type. 
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1 2 3 

o|l|2|3|4|5|6|7|8|9|o|l|2|3|4|5|6|7|8|9|o|l|2|3|4|5|6|7|8|9|o|l 

cbData 

vecHyperlink (variable) 


cbData (4 bytes): An unsigned integer that specifies the size in bytes of vecHyperlink. 
vecHyperlink (variable): MUST be a VecVtHyperlink structure (section 2.3.3.1.19 ). 

2.3.3.1.21 VtHyperlinks 

Specifies the format for a property representing a set of hyperlinks. This type conforms to the 
VT_BLOB TypedPropertyValue type as specified in rMS-OLEPSl section 2.15, but is presented in 
more detail here to further specify the contents of the data in this type. 



wType 


padding 


vtValue (variable) 


wType (2 bytes): An unsigned integer that MUST be equal to VT_BLOB (0x0041). 
padding (2 bytes): An unsigned integer that MUST be 6x0000. MUST be ignored. 
vtValue (variable): MUST be a VtHyperlinkValue structure (section 2. 3.3.1. 20) . 

2.3. 3.2 OLE Property Sets 

This section defines the format of a property set storage stream as specified in rMS-OLEPSl . This 
format applies to the Summary Information (section 2. 3. 3. 2.1) and Document Summary 
Information (section 2.3.3. 2. 2) streams. 

2. 3. 3. 2.1 Summary Information Property Set 

This section defines a simple OLE property set as specified in rMS-OLEPSl that conforms to the well- 
known property set format Summarylnformation as specified in rMS-OLEPSl section 2.23 and rMS- 
OLEPSl section 2.25.1. This specifies that the property set has the identifier GUID 
FMTID_SummaryInformation and is contained in the document stream named 
"\005SummaryInformation". It contains a fixed set of recognized properties, which are generally 
specified in the [MS-OLEPS] specification, but are specified in the following section with more details 
regarding their use or deviations from the simple OLE property set format pursuant to this 
specification. The format of this property set is as specified in [MS-OLEPS], except where stated 
otherwise in the following section. In addition, this property set MUST have the following: 
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■ This property set MUST have its PropertySetStream structure Version field set to 0x00000000. 

■ This property set MUST have its PropertySetStream structure CLSID field set to GUID_NULL. 

■ This property set MUST have a PropertySetSystemldentifier structure (section 2.3.3.1.11 for 

its PropertySetStream structure Systemldentifier field. 


For additional information about the OLE property set storage format, see [MS-OLEPS]. 

2.3. 3.2. 1.1 PIDSI 

Specifies the list of properties that can be defined in the Summary Information property set 
2. 3. 3. 2. I T This set MUST NOT contain a Dictionary property ( rMS-OLEPSl section 2.18.1) 


properties are optional, except the GKPIDSI_CODEPAGE property (section 2. 3.3. 2. 1,1 ) whii 
be written if the Summary Information property set (section 2.3.3.2.11 is present. All persisted 
string type properties ( Lpstr (section 2.3.3.1.41 . UnaliqnedLpstr (section 2.3.3. 1.51 . and Lpwstr 
(section 2. 3. 3.1. 6! ') MUST share the same code page encoding as specified by the 
GKPIDSI_CODEPAGE property (section 2. 3. 3.2.1. I I property. If the string properties are persisted 
as Lpwstr (section 2.3.3.1.61 type properties, the GKPIDSI_CODEPAGE property (section 
2.3.3.2.1.11 property MUST be set to CP_WINUNICODE (0x04B0). No order in persistence of the 
properties is enforced. All properties are persisted as TypedPropertyValue types as specified in 
rMS-OLEPSl section 2.15, except where indicated otherwise for the purpose of additional 
clarification or deviation from the specification. 



The Value column of the following table specifies the value o 

PropertyldentifierAndOffset structure ( [MS-OLEI 


5 the value of thi 
f cPS; section 2. 


the Propertyldentifier field for the 
19) for the specified property. 


The Meaning column of the following table specifies the property data type and the property's 
meaning. The property data type specifies the format of the Property field of the PropertySet 
structure ( rMS-OLEPSl section 2.20) for the given property. 


Name 

Value 

Meaning 

GKPIDSI_CODEPAGE 

0x00000001 

MUST be a VT 12 TvDedProDertvValue rMS-OLEPSl 
section 2.15) property. MUST conform to the CodePage 
DroDertv reauirements as specified in rMS-OLEPSl section 
2.18.2. 

GKPIDSI_TITLE 

0x00000002 

|\MUST be a VtStrino DroDertv (section 2.3.3.1.111. 
VtString.stringValue specifies the document title. 

GKPIDSI_SUBJECT 

0x00000003 

MUST be a VtStrino DroDertv (section 2.3.3.1.111. 
VtString.stringValue specifies the document subject. 

GKPIDSI_AUTHOR 

0X00000004 

MUST be a VtStrino DroDertv (section 2.3.3.1.111. 
VtString.stringValue specifies the document author. 

GKPIDSI_KEYWORDS 

■Sx00000005 

MUST be a VtStrino DroDertv (section 2.3.3.1.111. 
VtString.stringValue specifies the document keywords. 

GKPIDSI_COMMENTS 

0x00000006 

MUST be a VtStrino DroDertv (section 2.3.3.1.111. 
VtString.stringValue specifies comments corresponding 
to the document. 

GKPIDSI_TEMPLATE 

0x00000007 

MUST be a VtStrino DroDertv (section 2.3.3.1.111. 
VtString.stringValue specifies the name of the template 
on which the document is based. 
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Name 

Value 

Meaning 

GKPIDSI_LASTAUTHOR 

0x00000008 

MUST be a VtStrina DroDertv fsection 2.3.3.1.111. 
VtString.stringValue specifies the name of the author 
who last modified the document. 

GKPIDSI_REVNUMBER 

0x00000009 

MUST be a VtStrina DroDertv fsection 2.3.3.1.111. 
VtString.stringValue specifies the revision number for 
the document. MUST be the string representation of a 
non-negative whole number. 

GKPIDSI_EDITTIME 

OxOOOOOOOA 

MUST be a VT_FILETIME TypedPropertyValue ( 

OLEPS1 section 2.15) property. The value of the property 
does not specify a date and time as would be typical of the 
FILETIME data type fTMS-DTYPI section 2.3.1), but 
instead specifies duration. The value specifies the total 
time that the document has been opened for edit (in 
hundreds of nanoseconds). 

GKPIDSI_LASTPRINTED 

OxOOOOOOOB 

MUST be a VT_FILETIME TypedPropertyValue ffMS- 
OLEPS1 section 2.15) property. The value of the property 
specifies the date and time the document was last printed, 
in UTC time. 

GKPIDSI_CREATE_DTM 

OxOOOOOOOC 

MUST be a VT_FILETIME TypedPropertyValue ffMS- 
OLEPS1 section 2.15) property. The value of the property 
specifies the date and time the document was created, in 

utc tisrii. 

GKPIDSI_LASTSAVE_DTM 

OxOOOOOOOD 

MUST be a VT_FILETIME TypedPropertyValue (l~MS- 
OLEPS1 section 2.15) property. The value of the property 
specifies the date and time the document was last saved, 
in UTC time. 

GKPIDSI_PAGECOUNT 

OxOOOOOOOE 

I&IST be a VT 14 TvDedProDertvValue frMS-OLEPSl 
section 2.15) property. The integer value of the property 
specifies the pagi* count of the document. MAY be 

i^fc«l.<28> 

GKPIDSI_WORDCOUNT 

OxOOOOOOOF 

MUST be a VT 14 TvDedProDertvValue frMS-OLEPSl 
section Z15) property. The integer value of the property 
^specifies an estimate or an exact count of the words in the 
document. <29> MAY be ignored. <30> 

GKPIDSI_CHARCOUNT 

0x00000010 

MUST be a VT 14 TvDedProDertvValue frMS-OLEPSl 
section 2.15) property. The integer value of the property 
specifies an estimate of the character count of the 
document. MAY be ignored. <31> 

GKPIDSI_THUMBNAIL 

0x00000011 

MUST be a VtThumbnail DroDertv fsection 2.3.3.1.31. 

VtThumbnail.vtValue.cfDataBytes specifies the data 
that represents the thumbnail image for the document. 

GKPIDSI_APPNAME 

0x00000012 

MUST be a VtStrina DroDertv fsection 2.3.3.1.111. 
VtString.stringValue specifies the name of the 
application that produced the document. 

GKPIDSI_DOC_SECURITY 

0x00000013 

MUST be a VT 14 TvDedProDertvValue frMS-OLEPSl 
section 2.15) property. The value of the property specifies 
a bit field that details security properties of the document 
as follows: 


72 / 205 


[MS-OSHARED] - V20120122 
Office Common Data Types and Objects Structures 

Copyright © 2012 Microsoft Corporation. 

Release: Sunday, January 22, 2012 


Name 

Value 

Meaning 



■ If the value is equal to SECURITY_NONE 
(0x00000000), there are no security states specified 
by the property. 

■ If the SECURITY_PASSWORD bit is set (0x00000001), 
the document MUST be password protected. 

■ If the S ECU RITY_READO NLYRECOMMEND bit is set 
(0x00000002), it specifies that opening the document 
read-only is recommended but not enforced. 

■ If the SECURITY_READONLYENFORCED bit is set 
(0x00000004), it specifies that the document is always 
opened read-only. 

■ If the SECURITY_LOCKED bit is set (0x0006tt§g), it 
specifies that the document is always opened read-only 
except for annotations. 


2. 3. 3. 2. 2 Document Summary Information Property Set 

This section defines a simple OLE property set as specified in rMS-OLEPSl containing application- 
defined properties. This property set conforms to rMS-OLEPSl section 2.21 and rMS-OLEPSl section 
2.23 with regards to the stream name requirements and format identifier GUID for the 
FMTID_DocSummaryInformation property set. The Document Summary Information property set is 
contained in the document stream named "\005DocumentSummaryInformation" and contains 
a fixed set of recognized properties, which are specified in the following section. In addition, this 
property set MUST have the following: 

■ This property set MUST have its PropertySetStream structure Version field set to 0x00000000. 

■ This property set MUST have its PropertySetStream structure CLSID field set to GUIDJMULL. 

■ This property set MUST have a PropertvSetSvstemldentifier structure (section 2.3.3.1.11 for its 

PropertySetStream structure Systemldentifier field. 

The total size of this property set's PropertySet structure ( rMS-OLEPSl section 2.20) MUST be 
padded to a multiple of 4 bytes. The padding, if needed, MUST be located after the final property 
value of the property set and MUST be the minimum size required to produce a PropertySet 
structure with a size that is a multiple of 4 bytes. The contents of the padding are undefined and 
MUST be ignored. The PropertySet structure's Size field MUST include the count of padding bytes 
in its calculation. 

For additional information about the OLE property set storage format, see [MS-OLEPS]. 

2.3. 3.2. 2.1 PIDDSI 

Specifies the list of properties that can be defined in the Document Summary Information property 
set (section 2. 3. 3. 2. 2 ). This set MUST NOT contain a Dictionary property ( rMS-OLEPSl section 
2.18.1). All properties are optional, except the GKPIDDSI_CODEPAGE property (section 2.3.3.2.2.1) 
which MUST be written if the Document Summary Information property set (section 2.3.3.2.21 is 
present. All persisted string type properties ( Lpstr (section 2.3.3. 1.4) . UnaliqnedLpstr (section 
2.3.3. 1.5 ). and Lpwstr (section 2.3.3. 1.6) ) MUST share the same code page encoding as specified 
by the GKPIDDSI_CO DEPAGE property (section 2. 3. 3. 2. 2.1) . If the string properties are persisted as 
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Lpwstr (section 2. 3. 3. 1.6) type properties, the GKPIDDSI_CODEPAGE property (section 2. 3. 3.2. 2.1) 
MUST be set to CP_WINUNICODE (0x04B0). No order in persistence of properties is enforced. All 
properties are persisted as TypedPropertyValue types as specified in MS-OLEPS1 section 2.15, 
except where indicated otherwise for the purpose of additional clarification or deviation from the 
specification. 

The Value column of the following table specifies the value of the Propertyldentifier field for the 
PropertyldentifierAndOffset structure ( rMS-OLEPSl section 2.19) for the specified property. 


The Meaning column of the following table specifies the property type and description. The type 
specifies the format of the Property field of the PropertySet structure ( rMS-OLEPSl section 2.20) 
for the given property. 


Name 

Value 

Meaning 

GKPIDDSI_CODEPAGE 

0x00000001 

MUST be a VT_I2 TypedProperty^^UMSr 

OLEPS1 section 2.15) property. MUST conform to 
the CodePage property requirements as 
specified in rMS-OLEPSl section 2.18.2. 

GKPIDDSI_CATEGORY 

0x00000002 

MUST be a VtStrina property (section 

2. 3. 3.1. 1. VtStrina. strinaValue specifies a 
category nam^orthe document. 

GKPIDDSI_PRESFORMAT 

0x00000003 

MUST be a VtString property (section 


2. 3. 3. 1.111 . VtString.stringValue specifies the 
presentation format type of the document. MAY 
be. ignored. <32> MUST bOTine of the following 
values: 

Empty string 
On-screen Show <33> 

On-screen Show (4:3)<34> 

Letter Paper (8.5x11 in) 

Ledger Paper (11x17 in) 

A3 Paper (297x420 mm) 

A4 Paper (210x297 mm) 

B4 (ISO) Paper (250x353 mm) 

B5 (ISO) Paper (176x250 mm) 

B4 (JIS) Paper (257x364 mm) 

B5 (JIS) Paper (182x257 mm) 

Hagaki Card (100x148 mm) 

35mm Slides 

Overhead 

Banner 
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Name 

Value 

Meaning 



■ Custom 

■ On-screen Show (16:9)<35> 

■ On-screen Show (16: 10)<36> 

GKPIDDSI_BYTECOUNT 

0x00000004 

MUST be a VT_I4 TypedPropertyValue (TMS- 
OLEPS1 section 2.15) property. The integer value 
of the property specifies an estimate of the size 
of the document in bytes. MAY be ignored. <37> 

GKPIDDSI_LINECOUNT 

0x00000005 

MUST be a VT_I4 TypedPropertyValue (TMS- 
OLEPS1 section 2.15) property. The integer value 
of the property specifies an estimate of the 
number of text lines in the document. MAY be 
ignored. <3§> 

GKPIDDSI_PARACOUNT 

0x00000006 

MUST be a VT_I4 TypedPropertyValue (fMS- 
OLEPS1 section 2.15) yberty. The integer value 
of the property specifies either an estimate or an 
exact count of the number of paragraphs in the 
document. <39> MAY be ignored. <40> 

GKPIDDSI_SLI DECOUNT 

0x00000007 

MUST be aJ§T_I4 TypedPropertyValue (fMS- 
OLEPS1 section 2.15)^®perty. The integer value 
of the property specifies the number of slides in 
the document. MAY be ioimed.<41> 

GKPIDDSI_NOTECOUNT 

0x00000008 

MUST be a VTJ4 TypedPropertyValue ffMS- 
OLEPS1 section 2.15) property. The integer value 
of the property specifies the number of notes in 
the document. MAY be ignored. <42> 

GKPIDDSI_HIDDENCOUNT 

0x00000009 

MUST be a VT_I4 TypedPropertyValue (FMS- 
OLEPS1 section 2.15) property. The integer value 
of the property specifies the number of hidden 
^slides in the document. MAY be ignored. <43> 

GKPIDDSI_MMCLIPCOUNT 

0x0000 000A 

MUST be a VT_I4 TypedPropertyValue (TMS- 
OLEPS1 section 2.15) property. The integer value 
of the property specifies the number of 
multimedia clips in the document. MAY be 
ignored. <44> 

GKPIDDSI_SCALE 

OxOOOOOOOB 

MUST be a VT_BOOL TypedPropertyValue 

(TMS-OLEPS1 section 2.15) DroDertv. The value 
of the property MUST be FALSE. 

GKPIDDSI_HEADINGPAIR 

OxOOOOOOOC 

MUST be a VtVecHeadingPair DroDertv fsection 
2.3.3.1.151. Each VtHeadinaPair element fsection 
2.3.3.1.131 in 

VtVecHeadingPair.vtValue.rgHeadingPairs 

defines a heading string and a count of document 
parts as found in the GKPIDDSI_DOCPARTS 
DroDertv fsection 2.3.3.2.2.11 to which this 
heading applies. The total sum of document 
counts for all headers in this property MUST be 
equal to the number of elements in the 
GKPIDDSI_DOCPARTS property (section 
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Name 

Value 

Meaning 



2. 3. 3. 2. 2.1) DroDertv. 

GKPIDDSI_DOCPARTS 

OxOOOOOOOD 

MUST be a VtVecUnalianedLDStr fsection 

2.3.3.1.10) or VtVecLDwstr DroDertv fsection 

2. 3. 3. 1.8). Each strina element of the vector 
specifies a part of the document. The elements of 
this vector are ordered according to the header 
they belong to as defined in the 

GKPIDDSI HEADING PAIR property (section 

2. 3. 3. 2. 2.1). 

Example: The first element of the heading pair 
vector indicates that it has four document parts 
associated with it. Elements 1 to 4 of the 
document parts vector are grouped under this 
header. The next element of the heading pair 
vector indicates that it has three document parts 
associated with it. The document part vector 
elements 5 to 7 are grouped under this header, 
and so on. 

GKPIDDSI_MANAGER 

OxOOOOOOOE 

MUST be a VtString property (section 

2.3.3.1.11 ). VtStrinq.strinaValue specifies the 
manager associated with the document. 

GKPIDDSI_COMPANY 

OxOOOOOOOF 

MUST be a VtString property (section 

2.3.3.1.11). VtString. stringValue specifies the 
/company associated with the document's 
authoring. 

GKPIDDSI_LINKSDIRTY 

♦ i 

0x00000010 

MUST be a VT_BOOL TypedPropertyValue 

(rMS-OLEPSI section 2.15) property. The 
property value specifies TRUE (any value other 
thpivOxOOOOTOOO) if any of the values for the 
linked DroDerties in the User Defined ProDertv 

Set (lection 2.3. 3.2.3) have changed outside of 
the application, which would require the 
application to update the linked fields on 
document load.<45> 

70 

0x00000011 

MUST be a VT_I4 TypedPropertyValue (rMS- 
OLEPSI section 2.15) property. The integer value 
of the property specifies an estimate of the 
number of characters in the document, including 
whitespace. MAY be ignored. <46> 

•"( 7 , 

0x00000013 

MUST be a VT_BOOL TypedPropertyValue 

(rMS-OLEPS) section 2.15) DroDertv. The 
property value MUST be FALSE (0x00000000). 

GKPIDDSI LINKBASE 

0x00000014 

MUST NOT be written. The base URL property is 
persisted to the User Defined Property Set 
(section 2. 3. 3. 2. 3) with the PID LINKBASE 
property name. 

r"~ 

0x00000015 

MUST NOT be written. The hyperlinks property is 
persisted to the User Defined Property Set 
(section 2. 3. 3. 2. 3) with the PID H LINKS 
property name. 
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Name 

Value 

Meaning 

GKPIDDSI_HYPERLINKSCHANGED 

0x00000016 

MUST be a VT BOOL TypedPropertyValue 

rrMS-OLEPSl section 2.151 DroDertv. The 
property value specifies TRUE (any value other 
than 0x00000000) if the _PID_HLINKS 
property in the User Defined Property Set 
fsection 2.3.3.2.31 has chanaed outside of the 
application, which would require the application 
to update the hyperlink on document load.<47> 

GKPIDDSI_VERSION 

0x00000017 

MUST be a VT_I4 TypedPropertyValue ( 

OLEPS1 section 2.15) property. Specifies the 
version of the application that wrote the property 
set storage. The two high-order bytes specify an 
unsigned integer specifying the major version 
number. The two low-order bytes specify an 
unsigned integer specifying the minor version 
number. The value MUST have the major version 
number set to a nonzero value, and the minor 
version number SHOULD always be 0x0000. The 
minor version number MAY be set to the minor 
version number of the application that wrote the 
property set storage. <48 > 

GKPIDDSIDIGSIG 

0x00000018 

MUST be a VtDigSiq property (section 

2.3.3.1.171. VtDiaSia.vtValue SDecifies the data 
^)f the VBA digital signature for the VBA project 
embedded in the document. MUST NOT exist if 
the VBA project of the document does not have a 
digital signature or if the project is absent. MAY 
be ignored <49^^ 

GKPIDDSI_CONTENTTYPE 

0x0000001a 

MUST be a VtString property (section 

2.3.3 LI. VtString. stringValue specifies the 

content type of the file. MAY be absent. <50> 

GKPIDDSI CONTENTSTATUS 

♦ < 

0X0000001B 

MUST be a VtString property (section 

2. 3. 3.1.: 1. VtString. stringValue specifies the 
document status. MAY be absent. <51> 

GKPIDDSILANGUAGE 

OxOOOOOOlC 

MUST be a VtString property (section 

2.3.3.1.11). SHOULD be absent.<52> 

GKPIDDSI_DOCVERSION 

f OxOOOOOOlD 

MUST be a VtString property (section 

2.3.3.1.11). SHOULD be absent. <53> 


2. 3. 3. 2. 3 User Defined Property Set 

This section defines a simple OLE property set, as specified in rMS-OLEPSl . containing arbitrary 
user-defined properties. This property set conforms to rMS-OLEPSl section 2.21 and rMS-OLEPSl 
section 2.23 with regards to stream name requirements and format identifier GUID for the 
FMTIDJJserDefinedProperties property set. The User Defined property set is contained in the 
document stream named "\005DocumentSummaryInformation". It contains properties of 
arbitrary type and value (within the constraints specified in section 2.3.3.2.3.11 . and assigned any 
property name that meets the [MS-OLEPS] specification except for those names that are reserved 
as specified in section 2.3.3.2.3.2 . This property set also supports the concept of linked properties 
that use two property entries, one of which does not have an associated property name. The 
specification for these properties is specified in section 2.3.3.2.3.3 . Properties stored in this property 
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set have an effective Propertyldentifier maximum of OxOOFFFFFF due to reserved high-order bits 
for property entry link specification. In addition, this property set MUST have the following: 


■ This property set MUST have its PropertySetStream structure Version field set to 0x00000000. 

■ This property set MUST have its PropertySetStream structure CLSID field set to GUID_NULL. 

■ This property set MUST have a PropertvSetSvstemldentifier structure (section 2.3.3.1.1) for its 

PropertySetStream structure Systemldentifier field. 

The total size of this property set's PropertySet structure ( rMS-OLEPSl section 2.20) MUST be 
padded to a multiple of 4 bytes. The padding, if needed, MUST be located after the final prope 
value of the property set and MUST be the minimum size required to produce a Propert 
structure with a size that is a multiple of 4 bytes. The contents of the padding are undef 
MUST be ignored. The PropertySet structure's Size field MUST include the count of p 
in its calculation. 

For additional information about the OLE property set storage format, see [M! 

2. 3. 3. 2. 3.1 User Defined Property Set Constraints 


The User Defined property set (section 2.3.3. 
specified in rMS-OLEPSl section 2.18.2. 



The User Defined property set (section 2. 3. 3. 2. 3) is a location where user-def 
persisted by associating arbitrary property names to data of arbitrary types, 
format the data can take, which are specified in this section. 

2. 3. 3. 2. 3. 1.1 Required Properties 

Because the format of the User Defined property set (section 2. 3. 3.2. 3 ) MUST associate a name 
with each property (except for the Dictionary and CodePage properties and links associated with 
properties), the property set MUST have a Dictionary property as specified in rMS-OLEPSl section 

2.18.1 to make this association, and MUST follow the rules as specified in [MS-OLEPS] regarding 
property name and property identifier uniquene 


:ontain the CodePage property as 


2. 3. 3. 2. 3. 1.2 Supported Types 

The User Defined property set (section 2. 3. 3.2. 3) does not support every property type defined in 
the rMS-OLEPSl speci^^^ton. Each property in this property set (with the exception of the 
Dictionary and CodePage properties) MUST be in one of the following formats: 

■ VtStrina ( sectlMg^.1 . 

■ TypedPropertyValue ( [MS-OLEPS1 section 2.15), the type of which MUST be one of the 
following types: 

■VT_I4 (0x0003) 


■VT_R8 (0x000;.; 
■VT_BOOL (OxOOOB) 
■VT_FILETIME (0x0040) 
■VT_BLOB (0x0041) 
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2. 3. 3. 2. 3. 2 Reserved Properties 


The User Defined property set (section 2. 3. 3. 2. 3) has a number of names that are reserved for 
specific data. These names MUST only be used to specify the data for which the names are 
reserved. All of these properties are optional and can be absent. The reserved names and the data 
they specify are as specified in the following tables. 


Reserved name 

Format and description 

_PID_GUID 

MUST be a VT BLOB TvDedProDertvValue (TMS-OLEPS1 
section 2.15) property. SHOULD NOT be written. <54> MUST 
be ignored if encountered on read. The Size field of the BLOB 
data (specified in rMS-OLEPSl section 2.9) specifies the count 
of bytes for a null-terminated Unicode string stored in the 

Bytes field of the BLOB excluding any padding. If Size is 0, 
no data is written for the Bytes field and the property value 
MUST be treated as an empty string. Size MUST be even. The 
property data MUST be padded to a multiple of 4 bytes, but 
the contents of the padding are undefined and MUST be 
ignored. The property specifies a unique GUID, as specified in 
1MS-DTYP1. which specifies the identifier for the document. 

MUST NOT be linked. 

_PID_LINKBASE 

MUST be a VT BLOB TvDedProDertvValue HMS-OLEPSl 
section 2.15) property. The Size field of the BLOB data 
(sDecified in IMS-OLEPS1 section 2.91 SDecifies the number of 
bytes for a null-terminated Unicode string stored in the Bytes 
field of the BLOB excluding any padding. If Size is 0, no data 
is written for the Bytes field and the property value MUST be 
treated as an empty string. Size MUST be even. The property 
data MUST be padded to a multiple of 4 bytes, but the 
contents of the padding §re undefined and MUST be ignored. 

The property specifies the base URL for relative hyperlinks in 
the document. MUST NOTiJib linked. 

_PID_HLINKS 

MUST be a VtHvDerlinks DroDertv (section 2.3.3.1.21V 

Specifies a list of hyperlinks contained in the document. MUST 
NOT be linked. 

_MarkAsFinal 

MUST be a VT BOOL TvDedProDertvValue (rMS-OLEPSl 
section 2.15) property. If the property exists and the value is 
true, this specifies that the document is the final draft. MAY be 
igncipa.<55> 

Microsoft Theme 

MUST be a VtStrina DroDertv (section 2.3.3.1.11V SDecifies the 
name of the most recent theme applied to the document. MAY 
be ignored. <56> 

Presentation 

MUST be a VtStrina DroDertv (section 2.3.3.1.11V If the 
presentation document is created by using the first slide 
loaded from a slide library, this property in the created 
document specifies the document name that the first slide 
originated from. MAY be ignored. <57> 

SlideDescription 

MUST be a VtStrina DroDertv (section 2.3.3.1.11V If the 
presentation document is created by using the first slide 
loaded from a slide library, this property in the created 
document specifies a description of the slide that was used. 

MAY be ignored. <58> 
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Reserved name 

Format and description 

_AllowSignedDocumentWithoutReadOnly 

MUST be a VT BOOL TvDedProDertvValue ( rMS-OLEPSl 
section 2.15) property. If present and the value is true it 
specifies that the document that contains a document 
signature, as specified in rMS-OFFCRYPTOI section 2.5, and 
would otherwise be opened as read-only MUST instead be 
opened with both read and write permissions. MAY be 
ignored. <59> 

_TemplateID 

MUST be a VtStrina DroDertv (section 2.3.3.1.111. The value of 
this property can be used to open a Help topic that 
corresponds to the template. MAY be ignored. <60> 

The format of the VtString.stringValue.value field of this 
property, if it exists, MUST conform to the following ABNF 
TRFC52341 representation: 

_TemplateID = "TC" TemplatelD X.CID %x00 ^ 

TemplatelD = 8 (DIGIT) 

LCID = 4 (DIGIT) 

TemplatelD: Specifies the unique identifier of the template 
that was used to create the document. 

LCID: Specifies the LCID of thepgmplate that was used to 
create the document. 

<DIGIT> is defined in fRFC52341 »bDendix B. 


The following properties are associated with document workspace management. All of these 
properties MAY be ignored. <61 > 


Reserved name 

Format and description 

_SourceUrl 

MUST be a VtStrina DroDertv fsection 2.3.3.1.11). Specifies the URL of the source 
document on a server for a working copy of that document that is opened from a 
server document workspace. 

_CheckOutSrcUrl 

MUST be a VtString property. Specifies the URL of the document workspace from 
which the document was checked out. The length of the property value string MUST 
be less than or equal to 256 characters, including the terminating NULL 
character.<62> 

JJveCopylndex 

MUST be a VT 14 TvDedProDertvValue (rMS-OLEPSl section 2.15) orooertv. 

Specifies a time starrto for comparing the current state of a server document to a 
local copy of that document. The value MUST be generated by taking the modified 
date-time of the document file as a FILETIME data tvoe (TMS-DTYP1 section 

2.3.1), multiplying the high-order 4-byte unsigned integer of the modified date- 
time by 3, and adding the low-order 4-byte unsigned integer of the modified date- 
time, producing a 4-byte unsigned integer hash value that is the value of the 
property. 

The value of this property can be used to resolve potential conflicts between two 
different copies of a document stored in a document workspace. If this property 
value of a particular document is the same as the modified date-time of that 
document file, hashed as described previously, the document MUST be considered to 
be equivalent to the original shared version of the file on the document workspace. If 
one of any two copies of a document is the original shared version and the two 
copies of the document differ, then the other document MUST be considered newer. 

_SharedFileIndex 

MUST be a VtString property. If the length of the property value exceeds 255 
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Reserved name 

Format and description 

_SharedFileIndexl 

_SharedFileIndex/V 

characters, excluding the terminating NULL character, then it MUST be segmented 
into multiple properties, each no larger than 255 characters plus a terminating NULL 
character. If segmented, each segment MUST be a property of the VtString type and 
MUST be null-terminated. Each segment except for the last MUST contain 255 
characters of the value, with the last containing all remaining characters. The first 
segment MUST be named "_SharedFileIndex", and each successive segment MUST 
be named with an incremental index after this root name— so the second chunk 
would be named "_SharedFileIndexl", the third "_SharedFileIndex2", the eleventh 
"_SharedFileIndexlO", and so on. 

The reconstructed value of the property specifies the workspace to which the 
document belongs. The value SharedFilelndexValue is formatted according to the 
followina ABNF FRFC52341 representation: 

SharedFilelndexValue = [VersionNumber] GUID URL 

VersionNumber = 0000020000000000 

GUID = ASCII-LEFT-CURLY-BRACKET 8(ASCII-DIGIT-HEXADECIMAL) ASCII- 
HYPHEN-MINUS 4(ASCII-DIGIT-HEXADECIMAL) ASCII-HYPHEN-MINUS 4(ASCII- 
DIGIT-HEXADECIMAL) ASCII-HYPHEN-MINUS 4(ASCII-DIGIT-HEXADECIMAL) ASCII- 
HYPHEN-MINUS 12(ASCII-DIGIT- HEXADECIMAL) ASCII-RIGHT-CURLY-BRACKET 

URL = *(UTF16-ANY) 

VersionNumber: An optional field. If present it MUST be "0000020000000000" and 
is a reserved value. 

GUID: MUST be a GUID, as specified in [MS-DTYP], which specifies a unique 
identifier for the document. 

URL: Specifies the URL of the requested location of the file on the document 
workspace. If the location is already occupied by a document with a different GUID, 
the document could be relocated. 


The following properties are associated with smart document solutions. 


Reserved 

name 

J V T 

Format and description 

Solution ID 

MUST be a VtString property. It specifies the identifier<63> for the associated smart 
document sd'tttion. This property can be used to check whether the specified smart 
document solution is already installed and, if so, use the existing solution information to 
deternjine if the solution needs to be updated. If it is not previously installed, the solution is 
installed based on the value of the "Solution URL" property. MAY be ignored <64>. For more 
information about smart documents, see rMSDN-SDOI. The lenath of the DroDertv's 

VtString. stringValue. value field MUST be less than or equal to 51 characters, including 
the terminating NULL character. 

Solution 

URL 

MUST be a VtString property. It specifies the path to an XML expansion pack manifest 
file, which defines the contents of the smart document solution associated with the 
document. MAY be ianored<65>. For more information about XML expansion pack manifest 
files, see rMSDN-BDO'. The lenath of the DroDertv's VtStrinq.strinqValue. value field 

MUST be less than or equal to 256 characters, including the terminating NULL character. 

Solution 

Template 

ID 

MUST be a VtString property. It specifies the identifier of a document template installed as 
part of the XML expansion pack. This property is used to ensure that the local copy of the 
document template installed as part of the XML expansion pack is updated when the 
document template referenced by the manifest file is updated. MAY be ignored<66>. For 
more information about XML expansion pack manifest files, see rMSDN-SDOI. The lenath of 
-the property's VtString. stringValue. value field MUST be less than or equal to 256 
characters, including the terminating NULL character. 

jypther 

MUST be a VtString property. It specifies the identifier<67> of a solution of type ’other’ 
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Reserved 

name 

Format and description 

Solution ID 

installed as a part of a XML expansion pack. For more information about XML expansion 

Dack and tvDes of solutions, see rMSDN-SDOl. This Drooertv is used when the solution itself 
does not affect the document behavior but it can be used to check if the referenced solution 
needs to be updated whenever the document is loaded. MAY be ianored<68>. The length of 
the property's VtString.stringValue. value field MUST be less than or equal to 51 
characters, including the terminating NULL character. 


The following properties are associated with managed code document add-in solutions <69> . For 
more information about managed code document add-in solutions, see rMSDN-AVSTOSl . These 
properties MUST both exist if present. 


Reserved name 

Format and description 

_AssemblyLocation 

_AssemblyLocationO 

_AssemblyLocationl 

_AssemblyLocation/V 

MUST be a VtString property. If the length of the property value exceeds 255 
characters, excluding the terminating NULL character, then it MUST be segmented 
into multiple properties, each no larger than 255 characters plus a terminating 

NULL character. If segmented, each segment MUST be a property of the VtString 
type and MUST be null-terminated. Each segment except for the last MUST contain 
255 characters of the value, with the last containing all remaining characters. 

If not segmented, the property name MUST be "_AssemblyLocation" or 
"_AssemblyLocationO". 

If segmented, the property segment names are generated by taking the root name 
"_AssemblyLocation" and appending the string representation of the decimal 
numbers 0, 1, 2, and so on. 

Therefore, the first segment MUST be named "_AssemblyLocationO", the second 
"_AssemblyLocationl", the eleventh "_AssemblyLocationlO", and so on. 

The reconstructed value of the property specifies the path to be used to locate the 
managed assembly file specified by the "_AssemblyFile" property. 

MAY be ignored. <7Q> M 

_AssemblyFile 

_AssemblyFileO 

_AssemblyFilel 

_AssemblyFileA/ 

MUST be a VtString property. If the length of the property value exceeds 255 
characters, excluding the terminating NULL character, then it MUST be segmented 
into multiple properties, each no larger than 255 characters plus a terminating 

NULL character. If segmented, each segment MUST be a property of the VtString 
type and MUST be null-terminated. Each segment except for the last MUST contain 
|^255 characters of the value, with the last containing all remaining characters. 

If not segmented, the property name MUST be "_AssemblyFile" or 
"_AssemblyFileO". 

If segmented, the property segment names are generated by taking the root name 
"_AssemblyFile" and appending the string representation of the decimal numbers 

0, 1, 2, and so on. 

Therefore, the first segment MUST be named "_AssemblyFileO", the second 
"_AsserpblyFilel", the eleventh "_AssemblyFilelO", and so on. 

The reconstructed value of the property specifies the file name of the managed 
assembly file containing the code for the document add-in solution. 

MAY be ignored. 


The following properties specify information about a document that has been sent by using email, 
either for review or as an attachment, from an author to a reviewer or from a reviewer back to the 
author. These properties MAY be ignored. <72> 
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Reserved name 

Format and description 

_ReviewCycleID 

MUST be a VT_I4 TypedPropertyValue property (rMS-OLEPSl section 
2.15). Specifies a unique identifier for a document that was sent for 
review. 

_TentativeReviewCycleID 

MUST be a VT 14 TvDedProDertvValue DroDertv (TMS-0LEPS1 section 
2.15). Specifies a unique identifier for a document that was sent for 
review. If this property and the "_ReviewCycleID" property both exist in 
a document, then they MUST have the same value. 

_ReviewingToolsShownOnce 

MUST be a VtString property. MUST have a value of the empty string. 
Specifies that the client application has opened the document that was 
sent for review. 

_NewReviewCycle 

MUST be a VtString property. MUST have a value of the empty string. 
Specifies that the document was sent as an attachment or for review. 

MAY be ignored. <73> 

_AuthorEmail 

MUST be a VtString property. Specifies the email address from which the 
document was sent. The length of the property's 

VtString. stringValue.value field MUST be less than or equal to 256 
characters, including the terminating NULL character. 

_AuthorEmailDisplayName 

MUST be a VtString property. Specifies the display name of the email 
address from which the document was sent. The length of the property's 
VtString. stringValue.value field MUST be less than or equal to 256 
characters, including the terminating NULL character. 

_EmailSubject 

MUST be a VtString property. Specifies the subject of the email message 
with which the document was sent. The length of the property's 

VtString. stringValue.value field MUST be less than or equal to 256 
characters, including the terminating NULL character. 

_AdHocReviewCycleID 

MUST be a VT 14 TvDedProDertvValue DroDertv (TMS-OLEPS1 section 
2.15). Specifies a unique identifier for reviewing a document that was 
sent as an attachment. 

_PreviousAdHocReviewCycleID 

MUST be a VT_I4 TypedPropertyValue property (rMS-OLEPSl section 
2.15). Specifies a unique identifier for reviewing a document that was 
*|Sent as an attachment. SHOULD be ignored.<74> MAY be changed if the 
"_AdHocReviewCycleID" property was present when the document was 
opened; then the value of the "_PreviousAdHocReviewCycleID" property 
when the document is again sent as an attachment MUST be the same 
as the original value of "_AdHocReviewCycleID". 

_EmailStoreID 

_EmailStoreIDO 

_EmailStoreIDl 

)<r 

MUST be a VtString property. Specifies an identifier of the email server 
of the reviewer who is returning the document to the author. If the 
length of the property's VtString. stringValue.value field exceeds 255 
characters, excluding the terminating NULL character, then it MUST be 
segmented into multiple properties, each no larger than 255 characters 
plus a terminating NULL character. If segmented, each segment MUST 
be a property of the VtString type and MUST be null-terminated. Each 
segment except for the last MUST contain 255 characters of the value, 
with the last containing all remaining characters. The name of each 
segment MUST be the base property name appended with the ASCII 
character whose value is equal to the value of the character '0' plus one 
less than the ordinal of the segment; hence, the first segment MUST be 
named "_EmailStoreID0", the second "_EmailStoreIDl", the eleventh 
"_EmailStoreID10", and so on. 
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Reserved name 

_EmailEntryID 

_EmailEntryIDO 

_EmailEntryIDl 

_EmailEntryIDA/ 


Format and description 

MUST be a VtString property. Specifies an identifier of the email 
message of the reviewer who is returning the document to the author. If 
the length of the property's VtString. stringValue. value field exceeds 
255 characters, excluding the terminating NULL character, then it MUST 
be segmented into multiple properties, each no larger than 255 
characters plus a terminating NULL character. If segmented, each 
segment MUST be a property of the VtString type and MUST be null- 
terminated. Each segment except for the last MUST contain 255 
characters of the value, with the last containing all remaining characters. 
The name of each segment MUST be the base property name appended 
with the ASCII character whose value is equal to the value of th< 
character '0' plus one less than the ordinal of the segment; hej 
first segment MUST be named "_EmailEntryIDO", the second 
"_EmailEntryIDl", the eleventh "_EmailEntryID10", and so on. 



2. 3. 3. 2. 3. 3 Linked Properties 

The specification for a simple OLE property set storage as specified in rMS-OLEPSl specifies thl 
properties contained in a property set storage can be named, when that property set storage 
contains the special Dictionary property. As specified previously, the User Defined property set 
(section 2. 3. 3. 2. 3) MUST contain a Dictionary property, and all properties of the property set 
except those that are special properties as specified in rMS-OLEPSl section 2.18 have names. 
However, the properties in this property set, excluding the special properties and Reserved 
Properties (section 2.3.3.2.3.21 , can also be linked, meaning they receive their value from document 
content instead of from explicit value assignment. 

A link for any property that allows it, if applicable, MUST be specified by creating an additional entry 
in the property set that is unnamed (that is, does not have an associated entry in the Dictionary 
property table). The Propertyldentifier ( S-OLEPS1 section 2.19) for an entry created for this 
purpose is equal to its associated property's Propertyldentifier combined with the value 
0x01000000 by using the bitwise OR operation. 

A property's link entry MUST be in VtString (section 2.3.3.1.11 ) format. 

The presence of such an associated link for a given property specifies that the property, when 
written, MUST generate its value from the document content to which it is linked. <75> On 
document load, pursuant to the specification of the GKPIDDSI LINKSDIRTY property flag (section 
2.3. 3.2. 2.1) . the application MUST update the linked document content in accordance with the new 
value of any linked property that was changed outside of the application. 

2.3.4 SmartTag Objects 

The smart tags are customer-defined semantics which can be embedded in a document. Smart 
tags allow semantic information to be added around words or types of data (for example, dates, 
phone numbers or addresses) within a document to provide information about the type of data 
contained within. 

2.3.4. 1 PropertyBagStore 

This structure specifies the shared data for the smart tags embedded in the document. 
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1 2 3 

01234567890123456789012345678901 


cFactoidType 



.4. 2 1 Specifies the list of smart 


le cbHdr, sVer, cfactoid, 


cFactoidType (4 bytes): Unsigned integer specifying the 

factoidTypes member. 

factoidTypes (variable): An array of FactoidType 

tag types. 

cbHdr (2 bytes): Unsigned integer specifyii 
and cste fields. MUST be OxC. 

sVer (2 bytes): Unsigned integer specifying the vefifeln number of the structure. The high-order 
byte specifies the major version number. The low-order byte specifies the minor version 
number. MUST be 0x0100. 

cfactoid (4 bytes): Unsigned integer reserved for future use. MUST be ignored. 

cste (4 bytes): Unsigned integer specifying the count of elements in the stringTable field. 

stringTable (variable): An array of PBStrinq (section 2.3.4.5) . Specifies the list of strings. 
Elements of this table are referenced by their indices to form key/value pairs by the 
keylndex and valuelndex fields iri Property (section 2. 3. 4. 4 ). which is in the properties 
field of PropertvBaq (section 2. 3. 4. 3 ). 


2. 3. 4.2 FactoidType 

Referenced by: Property Baa Store 
^Jiis structure specifies^ETie type of smart tag. 
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id (4 bytes): Unsigned integer specifying the identifier of this smart tag type. There %% many- 
to-one mapping from the PropertvBaq (section 2.3.4.3) to FactoidType (section 2.3. 4. 2) using 
their respective id fields. MUST be less than or equal to OxFFFF. 

rgbUri (variable): A PBStrinq structure (section 2. 3. 4. 5) specifying the XML namespace 
Uniform Resource Identifier (URI) for the smart tag type. 

rgbTag (variable): A PBString structure (section 2. 3.4.5 ) specifying the tag name for the smart 
tag type. 

rgbDownLoadURL (variable): A PBString structure (section 2. 3. 4. 5 ) specifying the URL to 
download the particular smart tag type. 

2. 3. 4. 3 PropertyBag 

This structure specifies the smart tag data. 


cbl 



cbUnknown (2 bytes): Unused, reserved for future use. MUST be 0x0 and MUST be ignored. 
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properties (variable): An array of Property (section 2.3. 4. 4) . It is a list of key/value indexes 
into the stringTable field of the PropertyBagStore (section 2.3.4.1) structure. 

2. 3. 4. 4 Property 

Referenced by: ProoertvBaa 

This structure specifies the indexes into the string table entries of the stringTable field in the 
PropertyBagStore (section 2.3.4. 1 ) to form a key/value pair. It is used by the smart tag 
recognizer to store additional information that relates to the smart tag in a collection of key/value 
pairs, known as a property bag. This information can be later used to perform common tasks for the 
data type. 
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keylndex (4 bytes): Unsigned integer specifying the key indi 
valuelndex (4 bytes): Unsigned integer specifying the value index. 

2. 3. 4. 5 PBString 

Referenced by: FactoidTvoe. PropertyBagStore 

This structure specifies a null-terminated string encoded either using a Unicode or ANSI character 
set format. 




678 9012345678901 


rgxch (variable) 



cch (15 bits): Specifies the count of characters in the string rgxch. 

A - fAnsiString (1 bit): If set to 0x1 the string rgxch MUST be an ANSI character set string. If 
set to 0x0 then it MUST be a Unicode string. 

rgxch (variable): A null-terminated ANSI character set or a Unicode string depending on the 
value of fAnsiString field. 

RefEdit Control 

:tBox control, as specified by a MorphData control structure in rMS-OFORMSI section 2.2.5, 
the following exceptions: 

ShowDropButtonWhen, specified in rMS-OFORMSI section 2.5.77, MUST have the value 
fmShowDropButtonWhenAlways. 
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■ DropButtonStyle, specified in rMS-OFORMSl section 2.5.22, MUST have the value 
fmDropButtonStyleReduce. 

All other properties of a RefEdit control are specified to have the same file format default values as 
a MorphData control structure, as specified in rMS-OFORMSl section 2.2.5, with a DisplayStyle 
property value of "fmDisplayStyleText", as specified in rMS-OFORMSl section 2.5.20. 

2.3.6 Custom XML Data Storage 

The Custom XML Data Storage specifies how to store a collection of XML fragments. It can be used 
to roundtrip arbitrary custom XML data with the document. This storage SHOULD <7@> be created 
to store any XML fragment. 

The name of this storage MUST be "MsoDataStore". Within this storage, zero or more sub-storages 
exist. The name of each of these sub-storages MUST be unique. Each of these sub-storages MUST 
contain two streams within it as specified in section 2.3.6.1 and 2.3.6.2 respectively. 

2.3.6. 1 Custom XML Data Storage Item 

The name of this stream MUST be "Item". An instance of this stream contains an XML fragment. 


Custom XML Data Storage items whose root namespace appears in the following table are further 
specified. 


Root namespace 

Explanation 

http://schemas.microsoft.com/office/2006/customDocumentInformationPanel 

Custom ProDertv Editor 

(section 2.3.6.1.11 

http://schemas.microsoft.com/office/2006/metadata/customXsn 

Custom Xsn (section 
2.3.6.1.21 

http://schemas.microsoft.com/office/2006/metadata/contentType 

Schema for Content Tvoe 

(section 2.3.6.1.31 

http://schemas.microsoft.com/office/2006/coverPageProps 

Cover Paae ProDerties 

(section 2.3.6.1.41 

http://schemas.microsoft.com/office/2006/metadata/longProperties 

Lona Properties (section 
2.3.6.1.5) 

office. server.policy 

Collaborative Application 
Markup Language (CAML) 
Structure Specification 
(rMS-WSSCAMLl section 

2.5. 1.7) 


2. 3. 6. 1.1 Custom Property Editor 

This section specifies the XML schema for the list and settings for any XSN files (as specified by 
InfoPath Form Template Format Structure Specification rMS-IPFFl l that are associated with the 
document to edit information in its custom XML data items. 

2. 3. 6. 1.1.1 XMLNamespace 

pecifies the root namespace of custom XML data items that are appropriate for editing by the XSN 
ecified in the XSNLocation element (section 2.3.6.1.1.21 . 
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Parent element: customPropertvEditor (section 2.3. 6. 1.1.51 


2. 3. 6. 1.1. 2 XSNLocation 

Specifies the path to the XSN file. 

Parent element: customPropertvEditor (section 2.3.6.1.1.51 

2. 3. 6. 1.1. 3 showOnOpen 

This element specifies whether to present a UI to edit either the core properties or properties in one 
of the custom XML data items in the document as specified by the defaultPropertvEditorNamespace 
(section 2. 3. 6. 1.1.4 1. A setting of "true" specifies that the editing UI is displayed. If set to any other 
value or not present, the editing UI is not presented. 

Parent element: customPropertvEditors (section 2.3.6. 1.1.6 ) 

2. 3. 6. 1.1. 4 defaultPropertyEditorNamespace 

This element specifies the XML namespace that identifies the XSN to be shown by default when 
editing the properties contained in the custom XML data items of the document. 

Parent element: customPropertvEditors (section 2. 3. 6. 1.1. 6 ) 

2. 3. 6. 1.1. 5 customPropertyEditor 

This element associates a namespace with the location of an XSN file (as specified by InfoPath Form 
Template Format Structure Specification rMS-IPFFT) . The XMLNamespace (section 2. 3. 6. 1.1. 11 child 
specifies which custom XML data items are suitable for editing; the XSNLocation (section 
2.3.6.1.1.21 child specifies a path to the XSN file. 

Parent element: customPropertvEditors (section 2. 3. 6.1.1. 6 1 


Child elements 


XMLNames r (section 3. 6.1. 1.1 1 


XSNLocation (section 2.3.6.1.1.21 


2. 3. 6. 1.1. 6 customPropertyEditors 

This element specifies the list and settings for any XSN files (as specified by InfoPath Form Template 
Format Structure Specification [MS-IPFF11 that are associated with the document to edit information 
in its custom XML data items. 




defaultPropertvEditorName :: (section 3 .6.1.1.4 1 


showOnOpen (section 2.3.6.1.1.31 
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2. 3. 6. 1.2 Custom Xsn 


This section specifies the XML schema for specifying whether an XSN file (as specified by InfoPath 
Form Template Format Structure Specification rMS-IPFFH is presented for editing information in the 
custom XML data item with the namespace of 

http://schemas.microsoft.com/office/2006/metadata/properties in the document. 



2.3. 6.1. 2.1 ST_TrueFalse 

This simple type specifies restriction for specifying the Boolean values. 

False : false 
True : true 

Referenced by: cached, openBvDefault 

2. 3. 6. 1.2. 2 xsnLocation 

This element specifies the location of an XSN file (as specified by InfoPath Form Template Format 
Structure Specification rMS-IPFF~0 to use for editing information in the custom XML data item with 
the namespace http://schemas.microsoft.com/office/2006/metadata/properties in the document. 

Parent element: customXsn (section 2. 3. 6. 1.2. 61 

2.3. 6.1. 2. 3 cached 

This element specifies whether to use the XSN specified by the xsnLocation (section 2.3.6.1.2.2^ for 
editing the information in the custom XML data item with the namespace 

http://schemas.microsoft.com/office/2006/metadata/properties in the document. If set to false the 
specified XSN MUST be used. If set to "True" the specified XSN MUST NOT be used. 

Parent element: customXsn (section 2.3.6.1.2.6') 

2. 3. 6. 1.2. 4 openByDefault 

This element specifies whether to present UI to edit information in the custom XML data item with 
the namespace http://schemas.microsoft.com/office/2006/metadata/properties in the document, 
immediately after opening the same. 

A value of true specifies that the UI is shown by default. A value of false or the absence of the 
element specifies that the UI is not shown. 

Parent element: cu stomXsn (section 2. 3. 6. 1.2.61 

2. 3. 6. 1.2. 5 xsnScope 

Specifies the path to use for resolving any relative paths that appear within the XSN specified by 
xsnLocation (sectio WP^n,.2.2') . 

Parent element: customXsn (section 2. 3. 6. 1.2.61 

6. 1.2. 6 customXsn 

lis element specifies whether an XSN file (as specified by InfoPath Form Template Format 
ructure Specification rMS-IPFF~n is to be presented for editing information in the custom XML data 
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item with the namespace of "http://schemas.microsoft.com/office/2006/metadata/properties" in the 
document. 


Child elements: 
cached (section 2.3.6.1.2.3) 
openBvDefault (section 2.3.6.1.2.4) 
xsnLocation (section 2.3.6. 1.2.2) 
xsnScope (section 2.3.6.1.2.5) 

2. 3. 6. 1.3 Schema for Content Type 

This section specifies the XML schema for the custom XML data item that specifies properties of the 
content type associated with the document. 

2. 3. 6. 1.3.1 ContentTypeld 

This simple type specifies restriction for specifying a content type identifier for a document. 
Referenced by: contentTypeSchema. SchemaForContentTvoe&con^ ^TyoelD , 

2. 3. 6. 1.3. 2 IntNonNegative 

This simple type specifies the restriction for specifying non-r :ger^ 

Referenced by: contentTypeSchema. Schema ForContentType reversion, 

DummvContentTvoeEiement.DummvContentTvoe&index 

2. 3. 6. 1.3. 3 UniqueldentifierWithoutBraces 

This simple type specifies the restriction on the UniqueldentifierWithoutBracesOrEmptv (section 
2.3.6. 1.3.4) data type for specifying a GUID. 

Referenced by: DummvContentTvoeElement. DummvContentType&web 



2. 3. 6. 1.3. 4 UniqueldentifierWithoutBracesOrEmpty 

This simple type specifies the restrictions for specifying a GUID without braces or an empty string. 
Referenced by: DummvContentTypeElement. DummvContentType(S>web 

2. 3. 6. 1.3. 5 DummyContentTypeElement 

This specifies the child schema for the contentTypeSchema (section 2. 3. 6.1.3. 7 ). 

Attributes: 

anchorld : Specifies the term that parents all terms that can be selected as a valid value for the 
property corresponding to this xsd:element. 

If set to 00000000-0000-0000-0000-000000000000, specifies that all terms in the term set 
specified by the termSetld attribute MUST be treated as valid values for the property 
corresponding to this xsdielement. 
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MUST be present on xsd:elements for which the taxonomy attribute is set to true. 

If applied to any other element, this attribute MUST be ignored. 

decimals : When applied to an xsdielement in a schema other than the root schema whose 
content model is an xsd: restriction based on 

{http://schemas.microsoft.com/office/2006/documentManagement/types3-Currency or 
{http://schemas.microsoft.com/office/2006/documentManagement/types3-Number, specifies the 
number of fractional digits to display in the property-editing UI for the property corresponding to 
this xsdielement. 

If applied to any other element, this attribute MUST be ignored. 

default : When applied to an xsd:element in a schema other than the root schema or the core 
schema, specifies the initial value of the property corresponding to this xsdielement. 

When applied to an xsdielement in a schema other than the root schema or core schema whose 
content model is an xsd restriction based on 

{http://schemas.microsoft.com/office/2006/documentManagement/types3-DateTime, if set to 
"[today]", specifies that the initial value of the property corresponding to this xsdielement MUST 
be set to the current UTC date and time. 

When applied to an xsdielement in a schema other than the root schema or core schema whose 
content model is an xsd restriction based on 

{http://schemas.microsoft.com/office/2006/documentManagement/types3-Boolean, the value of 1 is 
interpreted as logical true and all other values as logical false in determining the initial value of the 
property corresponding to this xsdielement. 

If applied to any other element, this attribute MUST be ignored. 

description : When applied to an xsdielement in a schema other than the root schema, specifies 
the description of the property corresponding to this xsdielement. 

If applied to any other element, this attribute MUST be ignored. 

displayName : When applied to an xsdielement in a schema other than the root schema or core 
schema, specifies the display name for the property corresponding to this xsdielement. 

If applied to any other - , element, this attribute MUST be ignored, 
fieldld : Specifies a unique identifier for the field. 

MUST be present on xsd:elements for which the taxonomy attribute is set to true. 

If applied to any other element, this attribute MUST be ignored. 
fieldsID : This attribute MUST be ignored. 

format i When applied to an xsdielement in a schema other than the root schema or core schema 
whose content model is an xsd restriction based on 

{http://schemas.micrdS0ft.com/office/2006/documentManagement/types>DateTime, if set to 
"DateTime" specifies that the property value corresponding to this xsdielement MUST include both 
the date and time, and if not present or set to any other value, specifies that the property value 
MUST include only the date. 

If applied to any other element, this attribute MUST be ignored. 
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hidden : When applied to an xsd:element in a schema other than the root schema or core schema, 
if set to true, specifies that the property corresponding to this xsd:element MUST NOT be 
presented for editing. 

If applied to any other element, this attribute MUST be ignored. 

index : Specifies the ordering on the property-editing UI of xsd:elements bearing this attribute 
from schemas other than the root schema. 

First, the xsd:elements are broken into groups, as follows. 

The first group is composed of any xsd:element that is all of the following: 

■ Is not the "description" element in the core properties. 

■ Is not a simpleType restriction based on 
{http://schemas.microsoft.com/office/2006/documentManagement/types}Note. 

■ Is not a complex content based on any of 
{http://schemas.microsoft.com/office/2006/documentManagement/types3-MultiChoice, 
{http://schemas.microsoft.com/office/2006/documentManagement/types3-MultiChoiceFillIn, or 
{http://schemas.microsoft.com/office/2006/documentManagement/types3-MultiChoiceLookup. 

The second group is composed of the remaining xsd:elements bearing this attribute from schemas 
other than the root schema. 

The order within each group is the ascending order of the index attribute values. 

If an xsd:element in a schema other than the root schema or core schema does not have this 
attribute, it MUST NOT be presented for editing. 

If applied to any other element, this attribute MUST be ignored. 

indexed : When applied to an xsd:element for which neither the hidden nor readonly attributes 
are set to true in a schema other than the root schema or core schema, if set to true, specifies that 
the property corresponding to this xsd:element MUST be presented for editing. 

If applied to any other element, this attribute MUST« ignored. 

internalName : Specifies an internal name for the xsd:element bearing this attribute. It MUST be 
present on xsdielements in a schema other than the root schema or core schema. 

If applied to any other element, this attribute MUST be ignored. 

isKeyword : If set to true, specifies that the property-editing UI for the property corresponding to 
this xsd:element uses all available term stores and term sets. If set to false, specifies that the 
property-editing UI for the property corresponding to this xsd:element uses the term set specified 
by the termSetld attribute. 

MUST be present on xsd:elements for which the taxonomy attribute is set to true. 

If applied to any other element, this attribute MUST be ignored. 

LCID : When applied to an xsd:element in a schema other than the root schema or core schema 
whose content model is an xsd: restriction based on 

{http://schemas.microsoft.com/office/2006/documentManagement/types3-Currency, specifies the 
locale identifier as specified in rMS-LCIDI used to determine the currency symbol used in the display 
of the property corresponding to this xsd:element in the property-editing UI. 
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If applied to any other element, this attribute MUST be ignored. 

list : Specifies the list to obtain data from, when displaying the property corresponding to this 
xsd:element in the property-editing UI. 


MUST be present on xsd:elements for which neither the hidden nor readonly attributes are set to 
true in a schema other than the root schema or core schema whose content model is an 
xsd: restriction based on 

{http://schemas.microsoft.com/office/2006/documentManagement/types3-Lookup or 
{http://schemas.microsoft.com/office/2006/documentManagement/types3-MultiLookup. 

If applied to any other element, this attribute MUST be ignored. 

open : If set to true, specifies that new terms are allowed to be added to the term set specified by 
the termSetld attribute. If set to false, the property-editing UI MUST NOT allow new terms to be 
added to the term set specified by the termSetld attribute. 

MUST be present on xsd: elements for which the taxonomy attribute is set to true, and MUST be 
set to true if new terms are allowed to be added to the term set specified by the termSetld 
attribute. MUST be set to false otherwise. 

If applied to any other element, this attribute MUST be ignored. 

percentage : When applied to an xsd:element in a schema other than the root schema or core 
schema whose content model is an xsd restriction based on 

{http://schemas.microsoft.com/office/2006/documentManagement/types3-Currency or 
{http://schemas.microsoft.com/office/2006/documentManagement/types3-Number, if set to true, 
specifies that the property corresponding to this xsd:element MUST be displayed as a percentage in 
the property-editing UI, and if not present or set to any other value, specifies that the property 
corresponding to this xsd:element MUST NOT be displayed as a percentage in the property-editing 
UI. 

If applied to any other element, this attribute MUST be ignored. 


readonly : When applied to an xsdielement in a schema other than the root schema or core 
schema, if set to true, specifies that the property corresponding to this xsdielement MUST NOT be 
presented for editing. 

■ .is attribute 


If applied to any other element, this 


Jte MUST be ignored. 


requiredMultiChoice : When applied to an xsdielement in a schema other than the root schema 
or core schema whose content model is an xsd restriction based on 
{http://schemas.microsoft.com/office/2006/documentManagement/types3-MultiChoice, 
{http://schemas.microsoft.com/office/2006/documentManagement/types3-MultiChoiceFillIn, or 
{http://schemas.microsoft.com/office/2006/documentManagement/types3-MultiChoiceLookup, if set 
to "true", choices MUST be selected for the property corresponding to this xsdielement. 

If applied to any other element, this attribute MUST be ignored. 

root : MUST be set to true on the root schema element specified in the contentTypeSchema 
(section 2.3.6.1.3.7 3. It MUST NOT be applied to any other element. 

showField : Specifies the text displayed in the property-editing UI for the lookup options of the 
property corresponding to this xsdielement. 

MUST be present on xsdielements for which neither the hidden nor readonly attributes are set to 
true in a schema other than the root schema or core schema whose content model is an 
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xsdirestriction based on 

{http://schemas.microsoft.com/office/2006/documentManagement/types3-Lookup or 
{http://schemas.microsoft.com/office/2006/documentManagement/types3-MultiLookup. 


If applied to any other element, this attribute MUST be ignored. 


sspld : Specifies the term store identifier used in the property-editing UI for the property 
corresponding to this xsd:element. 

MUST be present on xsdielements for which the taxonomy attribute is set to true, and MUST 
set to 00000000-0000-0000-0000-000000000000 on xsdielements for which the isKeyword 
attribute is set to true. 


If applied to any other element, this attribute MUST be ignored. 

taxonomy : MUST be set to true on xsdielements in a schema other than the root schema 
schema whose content model has the following structure. 


AUST be 

rord 

( 

chema or core 


inOccurs="0" 


<xsd: complexType> 

<xsd : sequence> 

<xsd: element ref="pc : Terms" 
</xsd:element> 

</xsd: sequence> 

</xsd : complexType> 


It MUST NOT be applied to any other element. 


taxonomyFieldName i MUST be present on xsdielements 
set to true. 


ixOccurs="l"> 

rsr 

nents for which the taxc 


taxonomy attribute is 


If applied to any other element, this attribute MUST be ignored. 

taxonomyMulti : If set to false, specifies that only single values are displayed as valid in the 
property-editing UI for the property corresponding to this xsdielement. 


MUST be present on xsdielements 


! for which the taxc 


taxonomy attribute is set to true. 


If applied to any other element, this attribute MUST be ignored. 

-I in t-h 


the property-editing UI for the property corresponding 


termSetld : Specifies the term set used 
to this xsdielement. 

MUST be present on xsdielements for which the taxonomy attribute is set to "true", and MUST be 
set to 00000000-0000-0000-0000-000000000000 on xsdielements for which the isKeyword 
attribute is set to true. 

If applied to any other element, this attribute MUST be ignored. 


web :T/Wen applied to an xsdielement for which neither the hidden nor readonly attributes are 
set to true in a schema other than the root schema or core schema whose content model is an 
xsdirestriction based on 

illy ://schemas.microsoft.com/office/2006/documentManaqement/tvpes3- Lookup or 
{http://schemas.microsoft.com/office/2006/documentManagement/types3-MultiLookup, specifies the 
location of the website containing the list from which data is obtained to display the property 
corresponding to this xsdielement in the property-editing UI. 

If applied to any other element, this attribute MUST be ignored. 
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2. 3. 6. 1.3. 6 schema 


This element specifies an XML schema. 

Parent element: contentTypeSchema (section 2.3.6.1.3.7) 

2. 3. 6. 1.3. 7 contentTypeSchema 

The attributes and child elements of this element collectively specify a schema for the cus 
data item that specifies properties of the content type associated with the document. Ead 
this element is an xsd:schema (section 2.3.6. 1.3.6 ') element (as specified by rW3C-XSD~n 
specifies one or more elements that appear in the custom XML data item. These xsd:sche 
elements are decorated with attributes from the 

http://schemas.microsoft.com/office/2006/metadata/properties/metaAttributes namespac 
specified in section 2.3.6. 1.3.5 . 

This element MUST contain an xsd:schema child element that has the ma:root Root 

(DummyContentTypeElement.DummyContentType@root (section 2. 3. 6. 1.3 sy iMMbute v. 

true. This xsd:schema specifies the structure of the root element of this Custom XML Data Storage 
item. This xsd:schema MUST have its targetNamespace attribute set to 
http://schemas.microsoft.com/office/2006/metadata/properties. It MUST declare and import any 
namespaces used by its child elements that are specified by other xsd:schema child elements. This 
xsd:schema element MUST have a maifieldsID Field IDs Hash 

(DummyContentTypeElement.DummyContentType@fieldsID (section 2. 3.6. 1.3. 5 ) ) attribute. 
Additionally, this xsd:schema element MUST declare an element called properties with the 
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The value of the Name attribute is not "Modified_x0020_By", "Created_x0020_By", "Modified", 
"Created", or "FileLeafRef". 

The value of the StaticName attribute is not "Title", "Subject", "_Author", "Keywords", 
"_Comments", "_Category", "Slides", "ContentType", or "Status". 


The xsd:all element from the structure described previously MUST contain an xsd:element element 
for each Field element in the filtered fields set. This xsd: element MUST have a ref attribute. The 
value of the ref attribute MUST be a qualified reference to a type whose name is the value of the 
StaticName attribute of the Field element, and which resides in the namespace identified by the 
SourcelD attribute of the Field element. Furthermore, if the Required attribute is not present on 
the Field element, or if the attribute is present but its value is not true, or if the value of the Type 
attribute is "MultiChoice" or "LookupMulti", then a minOccurs attribute with value of 0 MUST be 
present on the xsd:element element. 

For each unique string that appears as the value of the SourcelD attributes on any Field element in 
fields, the contentTypeSchema element MUST contain an xsd:schema child whose 
targetNamespace attribute has that same value. Each xsd:schema MUST contain one 
xsd:element element for each Field whose SourcelD attribute is the same as the 
targetNamespace of the xsd:schema. 

Each xsd:element element MUST have a Name attribute whose value is the value of the 
StaticName attribute on the corresponding Field element. Each xsd:element element MUST have 
a ma:index Index (DummyContentTypeElement.DummyContentType@index (section ' 2. 3.6.1.3.51 1 
attribute whose value is the number of Field elements that appear before the corresponding Field 
element within the Fields element in the content type. If the Required attribute is not present on 
the corresponding Field element, or if the attribute is present but its value is not true, or if the 
value of the Type attribute is "MultiChoice" or "LookupMulti", a nullable attribute ( rW3C-XSD1 1 with 
value of true MUST be present on the xsd:element element. 


The following attributes can appear on each x 


ma:displayName Display Name 
(DummyContentTypeElement.Dum 

ma:decimals Decimals (Dumm 

2.3.6.1.3.51 1 

ma:default Default (Dum 

2.3.6.1.3.51 1 



lyName (section 2.3.6.1.3.5) 1 


_.jment.DummyContentType@decimals (section 


:entTypi 

:lement.DummyContentType@default (section 
:ontentTypeElement.DummyContentType@description 


ma:description Description (Dui 
(section 2.3.6.1. ^11: ma:format 

(DummyContentTypeElement.DummyContentType@format (section 2.3.6.1.3.51 1 

maihidden Hidden (DummyContentTypeElement.DummyContentType@hidden (section 

2.3.6.1.3.51 1 

ma:LCID LCID (DummyContentTypeElement.DummyContentType@LCID (section 2.3.6.1.3.5 11 
ma:list List (DummyContentTypeElement.DummyContentType@list (section 2.3.6.1.3.5) 1 

• ma:internalName Internal Name 

(DummyContentTypeElement.DummyContentType@internalName (section 2.3.6.1.3.5) 1 

■ ma:readOnly Read Only (DummyContentTypeElement.DummyContentType@readOnly (section 

2.3.6.1.3.51 1 
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■ ma:showField Show Field (DummyContentTypeElement.DummyContentType@showField 
(section 2.3.6.1.3.5I I 

■ maipercentage Percentage (DummyContentTypeElement.DummyContentType@percentage 
(section 2. 3. 6. 1.3.5 )) 

■ ma:web Web (DummyContentTypeElement.DummyContentType@web (section 2.3.6.1.3.5) ) 

■ mairequiredMultiChoice Required Multiple Choice 
(DummyContentTypeElement.DummyContentType@requiredMultiChoice (section 2. 3. 6. 1.3.5) ) 

The contentTypeSchema MUST have an xsdischema child element whose targetNamespace 

attribute has the value "http://schemas.openxmlformats.org/package/2006/metadata/core- 
properties". 

Child element: schema (section 2.3.6.1.3.6) 

Attributes: 

_ : MUST be empty and MUST be ignored. 

contentTypeDescription : MUST be the same value as the Description attribute of the 
ContentType element (as specified in Collaborative Application Markup Language (CAML) Structure 
Specification ( TMS-WSSCAMLl section 2. 4. 1.1) for the content type associated with the document. 

contentTypelD : Identifies the content type associated with the document. 

contentTypeName : MUST be the same value as the Name attribute of the ContentType element 
as specified in Collaborative Application Markup Language (CAML) Structure Specification ( TMS- 
WSSCAML1 section 2.4. 1.1) for the content type associated with the document. 

contentTypeScope : MUST be empty and MUST be ignored. 

contentTypeVersion : MUST be the same value as the Version attribute of the ContentType 
element as specified in Collaborative Application Markup Language (CAML) Structure Specification 
( rMS-WSSCAMLl section 2. 4. 1.1) for the content type associated with the document. 

versionID : Specifies the string hash used to determine if the definition of the content type 
associated with the document has changed since the last time the content type was applied to the 
document. The value MUST be computed as an MD5 hash (as specified in rRFC13211) of the 
substring that represents the ContentType element (beginning with "<ContentType" and ending 
with "</ContentType>", both strings included) within the SOAP result of the GetListContentType 
web service request ( TMS-LISTSWSI section 3.1.4.17). 

2. 3. 6. 1.4 Cover Page Properties 

This section specifies the XML schema for specifying properties used for the document cover 
paae <77> . 


2.3.6. 1.4.1 ST PublishDate 
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Parent element: CoverPaqeProperties (section 2.3.6. 1.4.8 ) 


2.3.6.1.4.3 Abstract 

Specifies the abstract of the document's content. 

Parent element: CoverPaqeProperties (section 2.3.6. 1.4. 8 ) 

2. 3. 6. 1.4. 4 CompanyAddress 

Specifies the address of the company to be used in the document. 
Parent element: CoverPaqeProperties (section 2.3.6. 1.4. 8 ) 

2. 3. 6. 1.4. 5 CompanyPhone 

Specifies the phone number of the company to be used in the document. 
Parent element: CoverPaqeProperties (section 2.3.6. 1.4.8 ) 

2. 3. 6. 1.4. 6 CompanyFax 

Specifies the fax number of the company to be used in the 




r the document cover page. 


Parent element: CoverPaqeProperties (section 2.3.6. 1.4.8 ' 

2. 3. 6. 1.4. 7 CompanyEmail 

Specifies the email address of the company to be used 
Parent element: CoverPaqeProperties (sectioi 

2. 3. 6. 1.4. 8 CoverPageProperties 
Specifies the parent element for properties usi! 

Child elements: 

Abstract (section 2. 3. 6.1. 4. 3 ) 

CompanyAddress fsection j^3.6.1.4 
CompanyEmail (section 2.3.6. 1.4^7) 

CompanyFax (section 2.3.6. 1.4. 61 
CompanyPhone (section 2. 3. 6.1. 4.5') 

PublishDate (section 2.3.6.1.4.2 i 

1.1.5 Long Properties 

; section specifies the XML schema for specifying the full content of the User Defined Properties 
:ion 2.3.3.2.3'i whose values exceed 255 characters. 
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2. 3. 6. 1.5.1 LongProp 


This element specifies the full value of a user-defined property that exceeds 255 characters. 

Parent element: LonqProperties (section 2.3.6.1.5.2) 

Attributes: 

name : Specifies the name of the user-defined property. 

2. 3. 6. 1.5. 2 LongProperties 

This element specifies the full content of user defined properties whose values exceed 
characters. 

Child element: LongProp (section 2.3.6.1.5.1! 

2. 3. 6. 2 Custom XML Data Storage Properties 

The name of this stream MUST be "Properties". An instance of this stream contains a 
conforming to the namespace 

http://schemas.openxmlformats.org/officeDocument/2006/customXml. It contains the set of 
properties which are specified for the corresponding custom XML data item. These properties consist 
of a unique ID for the custom XML data item and information about the set of XML schemas used by 
the custom XML data item. 

2.3. 6.2.1 ST_Guid 

This simple type specifies the restriction for specifying a 
Referenced by: datastoreltem.CustomXmlDataF 

2. 3. 6. 2. 2 schemaRef 

This element specifies a single XML schema that is associated with the custom XML data item. This 
XML schema is identified using its target namespace. 

Parent element: :hema Refs (section 2.3., 6.2.3! 

Attributes: 

uri : Specifies the target namespace for the XML Schema associated with this schema reference. 

2. 3. 6. 2. 3 schemaRefs 

This element specifies the set of XML schemas that are associated with the corresponding custom 
XML data item. If this element is present, then the set of XML schemas provided within MUST be 
used to validate the contents of the corresponding custom XML data item. If no child schemaRef 
(section 2. 3. 6. 2. 2 ) elements exist then XML schema validation MUST NOT be performed on the 
custom XML data item. 

I^^nt element: datastoreltem (section 2.3.6.2.4) 

Child element: schemaRef (section 2.3.6.2.2) 
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2. 3. 6. 2. 4 dataStoreltem 


This element specifies the properties for the corresponding custom XML data item. The set of 
properties specified within this element is attached to the custom XML data item. 

Child element: schemaRefs (section 2.3.6.2.3j 

Attributes: 

itemID : Specifies a GUID that uniquely identifies a single custom XML data item within the 
document. Each itemID value MUST be unique among all custom XML data items in the document. 

2.3.7 Hyperlinks 

This section specifies hyperlink-related objects. 

2.3.7. 1 Hyperlink Object 

This structure specifies a hyperlink and hyperlink-related information. 
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fileTime (optional) 


streamVersion (4 bytes): An unsigned integer that specifies the version number of the 
serialization implementation used to save this structure. This value MUST equal 2. 

A - hlstmfHasMoniker (1 bit): A bit that specifies whether this structure contains a moniker. 
If hlstmfMonikerSavedAsStr equals 1, this value MUST equal 1. 

B - hlstmflsAbsolute (1 bit): A bit that specifies whether this hyperlink is an absolui 
relative path. 


Value 

Meaning 

0 

This hyperlink is a relative path. 

1 

This hyperlink is an absolute path. 


C - hlstmfSiteGaveDisplayName (1 bit): A bit that specifies whether the creator 
hyperlink specified a display name. 

D - hlstmfHasLocationStr (1 bit): A bit that specifies wh^ 
hyperlink location. 

E - hlstmfHasDisplayName (1 bit): A bit that spe« 
display name. 

F - hlstmfHasGUID (1 bit): A bit that spep|| 
specified by rMS-DTYPl . 


ler this structure contains a 


s structure contains a GUID as 


G - hlstmfHasCreationTime (1 bit): A bit that sped 
creation time of the file that contains the hyperlink. 


; whether this structure contains the 


- hlstmfHasFrameName (1 bit): A bit that 
frame name. 


lecifies whether this structure contains a target 


I - hlstmfMonikerSavedAsStr (1 bit): A bit that specifies whether the moniker was saved as a 
string. 

J - hlstmfAbsFromGetdataRel (1 bit): A bit that specifies whether the hyperlink specified by 
this structure is an absolute path generated from a relative path. 

bits); MUST be zsm> and MUST be ignored. 

'iable): An optional HyperlinkStrinq (section 2. 3.7. 9 ) that specifies the display 
:erlink. MUST exist if and only if hlstmfHasDisplayName equals 1. 



idryeirrameName (variable): An optional HyperlinkString (section 2.3. 7. 9) that specifies the 
target frame. MUST exist if and only if hlstmfHasFrameName equals 1. 

loniker (variable): An optional HyperlinkString (section 2.3.7.9) that specifies the hyperlink 
moniker. MUST exist if and only if hlstmfHasMoniker equals 1 and 
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oleMoniker (variable): An optional HyperlinkMoniker (section 2.3. 7. 2) that specifies the 
hyperlink moniker. MUST exist if and only if hlstmfHasMoniker equals 1 and 

hlstmfMonikerSavedAsStr equals 0. 

location (variable): An optional HyperlinkString (section 2. 3. 7.9 ) that specifies the hyperlink 
location. MUST exist if and only if hlstmfHasLocationStr equals 1. 

guid (16 bytes): An optional GUID as specified by [MS-DTYP] that identifies this hyperlink. 
MUST exist if and only if hlstmfHasGUID equals 1. 

fileTime (8 bytes): An optional FileTime structure as specified by [MS-DTYP] that specifies the 
UTC file creation time. MUST exist if and only if hlstmfHasCreationTime equals 1. 

2. 3. 7. 2 HyperlinkMoniker 

Referenced by: CompositeMoniker, Hyperlink Object 



monikerCIsid (16 bytes): A class identifier (CLSID) that specifies the Component Object 
Model (COM) component that saved this structure. MUST be a value from the following table: 


Value 

Meaning 

{0x79EAC9E0, 0xBAF9, GAiCE, 0x8C, 0x82, 0x00, 

OxAA, 0x00, 0x4B, 0xA9, 0x0B} 

Data field contains a URLMoniker 
(section 2.3.7.6T 

{0x00000303, 0x0000, 0x0000, OxCO, 0x00, 0x00, 

0x00, 0x00, 0x00, 0x00, 0x46} 

Data field contains a FileMoniker 
(section 2.3.7.8T 

{0x00000309, 0x0000, 0x0000, OxCO, 0x00, 0x00, 

0x00, 0x00, 0x00, 0x00, 0x46} 

Data field contains a CompositeMoniker 
(section 2.3.7, 3T 

{0x00000305, 0x0000, 0x0000, { OxCO, 0x00, 0x00, 
0x00, 0x00, 0x00, 0x00, 0x46 } 

Data field contains an AntiMoniker 
(section 2.3.7. 4T 

{0x00000304, 0x0000, 0x0000, { OxCO, 0x00, 0x00, 
0x00, 0x00, 0x00, 0x00, 0x46 } 

Data field contains an ItemMoniker 
(section 2. 3. 7. 5). 


data (variable): A moniker of the type specified by monikerCIsid. 

2. 3. 7. 3 CompositeMoniker 

Referenced by: HyperlinkMoniker 
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This structure specifies a composite moniker. A composite moniker is a collection of arbitrary 
monikers. For more information about composite monikers see rMSDN-IMGCMIl . 
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monikerArray (variable) 














cMonikers (4 bytes): An unsigned integer that specifies the count of monikers i 

monikerArray. 

monikerArray (variable): An array of HyperlinkMonikers (section 2.3.7 
specifies a moniker of arbitrary type. 

2. 3. 7. 4 AntiMoniker 

Referenced by: HyperlinkMoniker 

This structure specifies an anti-moniker. An anti-moniker agtSbs the inverse of any moniker it is 
composed onto, effectively canceling out that moniker. In a composite moniker, anti-monikers are 
used to cancel out existing moniker elements, because monikers cannot be removed from a 
composite moniker. For more information about anti-monikers, see rMSDN-IMAMIl . 



4 I 5 6 I 7 8 9 I° 1 


T- 


count (4 bytes): An unsigned integer that specifies the number of anti-monikers that have been 
composed together to create this instance. When an anti-moniker is composed with another 
anti-moniker, the resulting composition would have a count field equaling the sum of the two 
count fields of the composed anti-monikers. This value MUST be less than or equal to 
1048576. 


2. 3. 7. 5 ItemMoniker 

Referenced by: HyperlinkMoniker 

This structure specifies an item moniker. Item monikers are used to identify objects within 
containers, such as a portion of a document, an embedded object within a compound document, or 
a range of cells within a spreadsheet. For more information about item monikers, see rMSDN- 
IMcdM 
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delimiterAnsi (variable): A null-terminated array of ANSI characters that specifies a delimiter 
for this moniker. Delimiters are used to separate monikers that are part of a collection of 
monikers in a composite moniker. The number of characters in the array is determined by the 
position of the terminating NULL character. 

delimiterUnicode (variable): An optional array of Unicode characters that specifies a delimiter 
for this moniker if the delimiter cannot be completely specified in ANSI characters. This field 
MUST exist if and only if delimiterLength is greater than the size of delimiterAnsi in bytes. 
The number of characters in the array is determined ly (delimiterLength - (size of 
delimiterAnsi in bytes)) 

itemLength (4 bytes): An unsigned integer that specifies the count of bytes in the itemAnsi 

and itemUnicode fields. 

itemAnsi (variable): A null-terminated array of ANSI characters that specifies the string used 
to identify this item in a collection of items. The number of characters in this array is specified 

by itemLength. 

itemUnicode (variable): An optional array of Unicode characters that specifies the string used 
to identify this item in a collection of items, if the string cannot be completely specified in 
ANSI characters. This field MUST exist if and only if itemLength is greater than the size of 
itemAnsi in bytes. The number of characters in the array is determined by (itemLength - 
AsK.e of ^Bbfau|^^eld in bytes)) / 2. 
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1 2 3 

01234567890123456789012345678901 


length 


url (variable) 


serialGUID (16 bytes, optional) 


serialVersion (optional) 


uriFlags (optional) 


length (4 bytes): An unsigned integer that specifies the size of this structure in bytes, excluding 
the size of the length field. 

The value of this field MUST be either the byte size of the url field (including the terminating 
NULL character) or the byte size of the url field plus 24. 

If the value of this field is set to the byte size of the url field, then the serialGUID, 
serialVersion, and uriFlags fields MUST NOT be present. 


If the value of this field is set to the byte size of the url field plus 24, then the serialGUID, 
serialVersion, and uriFlags fields MUST be present. 

url (variable): A null-terminated array of Unicode characters that specifies the URL. The number 
of characters in the array is determined by the positfdfi of the terminating NULL character. 

serialGUID (16 bytes): An optional GUID as specified by rMS-DTYPI for this implementation of 
the URL moniker serialization. This field MUST equal {0xF4815879, 0xlD3B, 0x487F, OxAF, 
0x2C, 0x82, 0>(SD, 0xC4, 0x85, 0x27, 0x63} if present. 

serialVersion (4 bytes): An optional unsigned integer that specifies the version number of this 
implementation of the URL moniker serialization. This field MUST equal 0 if present. 

uriFlags (4 bytes): An optional Flags structure (section 2.3.7.7) that specifies 

creation flags for an rRFC39861 compliant URI. 

2.3. 7.7 URICreateFlags 


is s' 
cr 


Referenced by: URLMoniker 

structure specifies creation flags for an rRFC39861 compliant URI. For more information about 
n flags, see rMSDN-CreateUril . 
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2 3 

1 

01234567890123456789012345678901 
ABCDEFGHIJKLMNOP reserved 



A - createAllowRelative (1 bit): A bit that specifies that if the URI scheme is unspecified andj& 
not implicitly "file," a relative scheme is assumed during creation of the URI. 

B - createAllowImplicitWildcardScheme (1 bit): A bit that specifies that if the URI scheme is 
unspecified and not implicitly "file," a wildcard scheme is assumed during creation of the URI. 

C - createAllowImplicitFileScheme (1 bit): A bit that specifies that if the URI scheme is 
unspecified and the URI begins with a drive letter or a UNC path, a file scheme is assumed 
during creation of the URI. 

D - createNoFrag (1 bit): A bit that specifies that if a URI query string is present, the URI 
fragment is not looked for during creation of the URI. 

E - createNoCanonicalize (1 bit): A bit that specifies that the scheme, host, authority, path, 
and fragment will not be canonicalized during creation of the URI. This value MUST be 0 if 

createCanonicalize equals 1. 

F - createCanonicalize (1 bit): A bit that specifies that the scheme, host, authority, path, and 
fragment will be canonicalized during creation of the URI. This value MUST be 0 if 

createNoCanonicalize equals 1. 

G - createFileUseDosPath (1 bit): A bit that specifies that MS-DOS path compatibility 
mode will be used during creation of file URIs. 

H - createDecodeExtralnfo (1 bit): A bit that specifies that percent encoding and percent 
decoding canonicalizations will be performed on the URI query and URI fragment during 
creation of the URI. This field takes precedence over the createNoCanonicalize field. This 
value MUST be 0 if createNoDecodeExtralnfo equals l. <78> 

I - createNoDecodeExtralnfo (1 bit): A bit that specifies that percent encoding and percent 
decoding canonicalizations will not be performed on the URI query and URI fragment during 
creation of the URI. This field takes precedence over the createCanonicalize field. This value 
MUST be 0 if createDecodeExtralnfo equals l. <79> 

J - createCrackUnknownSchemes (1 bit): A bit that specifies that hierarchical URIs with 
unrecognized URI schemes will be treated like hierarchical URIs during creation of the URI. 

This value MUST be 0 if createNoCrackUnknownSchemes equals 1. 

K - createNoCrackUnknownSchemes (1 bit): A bit that specifies that hierarchical URIs with 
unrecognized URI schemes will be treated like opaque URIs during creation of the URI. This 
due MUST be 0 if createCrackUnknownSchemes equals 1. 

aPreProcessHtmIUri (1 bit): A bit that specifies that preprocessing will be performed 
URI to remove control characters and white space during creation of the URI. This 
*HJST be 0 if createNoPreProcessHtmIUri equals 1. 

createNoPreProcessHtmIUri (1 bit): A bit that specifies that preprocessing will not be 
performed on the URI to remove control characters and white space during creation of the 
URI. This value MUST be 0 if createPreProcessHtmIUri equals 1. 
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N - createlESettings (1 bit): A bit that specifies that registry settings will be used to 

determine default URL parsing behavior during creation of the URI. This value MUST be 0 if 

createNoIESettings equals 1. 

O - createNoIESettings (1 bit): A bit that specifies that registry settings will not be used to 
determine default URL parsing behavior during creation of the URI. This value MUST be 0 if 

createlESettings equals 1. 

P - createNoEncodeForbiddenCharacters (1 bit): A bit that specifies that URI characters 
forbidden in rRFC39861 will not be percent-encoded during creation of the URI. 

reserved (16 bits): MUST be zero and MUST be ignored. 

2.3. 7.8 FileMoniker 

Referenced by: HyperlinkMoniker 


This structure specifies a file moniker. For more information about file monikers, see fMSDN-FMI . 
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ansiPath (variable): A null-terminated array of ANSI characters that specifies the file path. The 
number of characters in the array is specified by ansiLength. 

endServer (2 bytes): An unsigned integer that specifies the number of Unicode characters used 
to specify the server portion of the path if the path is a UNC path (including the leading "\\"). 
If the path is not a UNC path, this field MUST equal OxFFFF. 

versionNumber (2 bytes): An unsigned integer that specifies the version number of this file 
moniker serialization implementation. MUST equal OxDEAD. 

reservedl (16 bytes): MUST be zero and MUST be ignored. 
reserved2 (4 bytes): MUST be zero and MUST be ignored. 

cbUnicodePathSize (4 bytes): An unsigned integer that specifies the size, in bytel^of 

cbUnicodePathBytes, usKeyValue, and unicodePath. 

If the file path specified in ansiPath cannot be completely specified by ANSI characters, the 
value of this field MUST be equal to the size, in bytes, of the path as a Unicode string (without 
a terminating NULL character) + 6. If the path can be fully specified in ANSI characters then 
the value of this field MUST be set to zero. 

If the value of this field is greater than zero, then the cbUnicodePathBytes, usKeyValue 
and unicodePath fields MUST exist. 

If the value of this field is zero, then the cbUnicodePathBytes, usKeyValue, and 
unicodePath fields MUST NOT exist. 

cbUnicodePathBytes (4 bytes): An optional unsigrkd integefthat specifies the size, in bytes, 
of the unicodePath field. This field exists if and only if cbUnicodePathSize is greater than 
zero. 

usKeyValue (2 bytes): An optional unsigned integer that MUST be 3 if present. This field exists 
if and only if cbUnicodePathSize is greater than zero. 

unicodePath (variable): An optional array of Unicode characters that specifies the complete 
file path. This path MUST be the complete Unicode version of the file path specified in 
ansiPath and MUSTipcIude additional Unicode characters that cannot be completely specified 
in ANSI characters. The number of characters in this array is specified by 
cbUnicodePathBytes/2. This array MUST not include a terminating NULL character. This 
field exists if and only if cbUnicodePathSize is greater than zero. 

2. 3. 7. 9 HyperlinkString 

Referenced by: Hyperlink Object 


This structure specifies a string for a hyperlink. 
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length (4 bytes): An unsigned integer that specifies the number of Unicode characters in the 
string field, including the null-terminating character. 

string (variable): A null-terminated array of Unicode characters. The number of characters in 
the array is specified by the length field. 

2.3.8 MsoEnvelope 

This section specifies structures related to the MsoEnvelope structure (section 2. 3.8. 2 ). 

2.3.8. 1 MsoEnvelopeCLSID 

A structure that specifies the type of data in EnvelopeData based on the value of C 



CLSID (16 bytes): A GUID, as specified by [ MS -DTYP1 . that specifies the type of data in 
EnvelopeData. If this GUID equals { 0x0006F01A, 0x0000, 0x0000, { OxCO, 0x00, 0x00, 
0x00, 0x00, 0x00, 0x00, 0x46 > >, then the data in^velopeData is specified by 
MsoEnvelope structure (section 2.3. 8. 2) . If not, then the data in EnvelopeData is out of 
scope for this document. 

EnvelopeData (variable): An array of bytes that is either specified by MsoEnvelope structure 
(section 2. 3. 8. 2) or is out of scope, depending on the value of CLSID. 


2. 3. 8. 2 MsoEnvelope 
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RequestStrSi; 


RequestStr (variable) 


SentRepresentingEntryldSize 
SentRepresentingEntryld (variable) 

SentRepresentingNameSize SentRepresentingName (variable) 

InetAcctStampSize InetAcctStamp (variate) 

InetAcctNameSize InetAcctName (variable) 

ExpiryTime 

DeferredDeliveryTime 

DeleteAfterSubmit 

SecurityFlags 

OriginatorDeliveryReportRequested 

ReadReceiptRequested 

CategoriesStrSize CategoriesStr (variable) 

Sensitivity 

Importance 

SubjectSize Subject (variable) 
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VotingOptionsSize 


VotingOptions (variable) 


ReplyRecipients (variable) 


ContactLinkRecipients (variable) 


Recipients (variable) 


Attachments (variable) 


IntroText(.yariable) 


RC 

o 


Ver (4 bytes): An unsigned integer that specifies the version of this envelope. 

LastSentTime (4 bytes): A signed integer that specifies the last time this email message was 
sent. Time is represented as the number of minutes since 12:00 AM January 1, 1601. The 
value MUST be greater than or equal to 0 and less than or equal to 0x5AE980E0. The default 
value is 0x5AE980E0, which means no time was specified. 

FlagStatus (4 bytes): An unsigned integer that specifies the follow-up status of this email 
message. Values are zero for not flagged for follow-up, 1 for flagged for follow-up, and 2 for 
completed follow-up. 

RepiyTime (4 bytes): A signed integer that specifies when the last reply was received for this 
email message. The time is represented as the number of minutes since 12:00 AM January 1, 
1601. The value MUST be greater than or equal to zero and less than or equal to 0x5AE980E0. 
The default value is 0x5AE980E0, which means no time was specified. 

RequestStrSize (2 bytes): An unsigned integer that contains the size, in characters, of 

RequestStr. 

RequestStr (variable): A character array that contains the request string. For example, if the 

I sender has set a flag on this email message with "No Response Necessary", this string 

contains "No Response Necessary". If Ver is 6, this is an ANSI character set array. If Ver is 8, 
this is a Unicode character array. 

SentRepresentingEntryldSize (4 bytes): An unsigned integer that contains the size, in bytes, 

of SentRepresentingEntryld. 
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SentRepresentingEntryld (variable): An array of bytes that specifies the 
PR_SENT_REPRESENTING_ENTRYID as specified in rMS-OXPROPSl . 

SentRepresentingNameSize (2 bytes): An unsigned integer that contains the size, in 
characters, of SentRepresentingName. 

SentRepresentingName (variable): A character array that specifies the 

PR_SENT_REPRESENTING_NAME as specified in [MS-OXPROPS]. If Ver is 6, this is an AMCT 
character set array. If Ver is 8, this is a Unicode character array. 

InetAcctStampSize (2 bytes): An unsigned integer that contains the size, in characte 

InetAcctStamp. 

InetAcctStamp (variable): A character array that specifies the dispidlnetAcctStami 

specified in [MS-OXPROPS]. If Ver is 6, this is an ANSI character set array. If Ver is 
a Unicode character array. 

InetAcctNameSize (2 bytes): An unsigned integer that contains the size, in character 

InetAcctName. 

InetAcctName (variable): A character array that contains the dispidlnetAcctName as 

specified in [MS-OXPROPS]. If Ver is 6, this is an ANSI character set array. If Ver is 8, this is 
a Unicode character array. 

ExpiryTime (4 bytes): A signed integer that specifies the time this email message expires. The 
time is represented as the number of minutes since 12:00 AM January 1, 1601. The value 
MUST be greater than or equal to 0 and less than or equal to 0x5AE980E0. The default value 
is 0x5AE980E0, which means no time was specified. 

DeferredDeliveryTime (4 bytes): A signed integer that specifies the time to send this email 
message. The time is represented as the number of minutes sinde 12:00 AM January 1, 1601. 
The value MUST be greater than or equal to 0 and less than or equal to 0x5AE980E0. The 
default value is 0x5AE980E0, which means no time was specified. 

DeleteAfterSubmit (4 bytes): An unsigned integer that specifies whether to delete the 

message after a recipient has submitted a reply. Values are zero for no, and 1 for yes. MUST 
be zero or 1. 

SecurityFlags (4 bytes): A bit field that specifies the security settings for this email message. 
The least significant bit specifies whether the email message is signed, and the next bit 
specifies whether the email message is encrypted. All other bits MUST be zero. 

OriginatorDeliveryReportRequested (4 bytes): An unsigned integer that specifies whether to 
send a delivery receipt to the sender. Values are zero for no and 1 for yes. MUST be zero or 1. 

bytes): An unsigned integer that specifies whether to send a read 
es are zero for no and 1 for yes. MUST be zero or 1. 

): An unsigned integer that contains the size, in characters, of 




tegoriesStr (variable): A character array that contains the category for this email message. 
For example, "Business" or "Favorites". If Ver is 6, this is an ANSI character set array. If Ver 
is 8, this is a Unicode character array. 
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Sensitivity (4 bytes): An unsigned integer that specifies the sensitivity of the email message. 
Values are zero for Normal, 1 for Personal, 2 for Private, and 3 for Confidential. MUST be less 
than 4. 

Importance (4 bytes): An unsigned integer that specifies the importance flag of the email 
message. Values are 0 for Low, 1 for Normal, and 2 for High. MUST be less than 3. 

SubjectSize (2 bytes): An unsigned integer that contains the size, in characters, of Subject. 

Subject (variable): A character array that contains the subject of the email message. If Ver is 
6, this is an ANSI character set array. If Ver is 8, this is a Unicode character array. 

VotingOptionsSize (2 bytes): An unsigned integer that contains the size, in characters, of the 

VotingOptions. 

VotingOptions (variable): An ANSI character array that contains the voting option choices 
separated by a semicolon. For example, "Yes;No;Maybe". 

ReplyRecipients (variable): An EnvRecipientCollection (section 2. 3. 8. 3 ) that contains the 
recipients of replies to this email message. 

ContactLinkRecipients (variable): An EnvRecipientCollection (section 2. 3. 8. 3 ) that contains 
the sender contacts to whom the email message is to be sent. This is not present if Ver does 
not equal 8. 

Recipients (variable): An EnvRecipientCollection (section 2. 3. 8. 3 ) that contains the recipients 
to receive this email message. 


Attachments (variable): An EnvAttachmentCol lection (section 2.3.8.17 ') that contains 
information about attachments for this email message. 
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RecipientCollTag (4 bytes): An unsigned integer that contains a version tag for the recipient 
collection. MUST be 0xDCCA0123. 

RecipientCollVer (4 bytes): An unsigned integer that contains a version for the recipient 
collection. MUST be 1. 

Count (4 bytes): An unsigned integer that contains the number of recipients in the Recipients 
array. 

Recipients (variable): An array of EnvRecipientProperties (section 2.3.8. 4 ) that contains the 
properties for each recipient. 

2. 3. 8. 4 EnvRecipientProperties 

Referenced by: EnvRecipientCollection 


An EnvRecipientProperties structure (section 2. 3.8. 4) that contains the properties of a single email 
message recipient. 



Count (4 bytes): An unsigned integer that contains the number of properties for this recipient. 

Ignored (4 bytes): MUST be ignored. 

Properties (variable): An array of EnvRecipientPropertv (section 2.3.8.5) that has the size of 

Count. 

2. 3. 8. 5 EnvRecipientProperty 

Referenced by: EnvRecipientProperties 

A single property for an email message recipient. These properties are specified in rMS-OXCDATAl . 
Only the sizes of the properties are described here. 



115/205 

[MS-OSHARED] - V20120122 
Office Common Data Types and Objects Structures 

Copyright © 2012 Microsoft Corporation. 

Release: Sunday, January 22, 2012 


PropTag (4 bytes): An unsigned integer that contains the property identifier tag. 


PropData (variable): An EnvRecipientPropertvBlob (section 2. 3. 8. 6) . the type of which is 
specified by PropTag. 


2. 3. 8. 6 EnvRecipientPropertyBlob 

Referenced by: EnvRecipientPropertv 

A structure that describes the size of the data for a single recipient property. The type of this 
structure is specified by the PropTag of a EnvRecipientProperty (section 2.3.8.5) . 


Value 

Meaning 

0x0003 

The property data is a PT LONG (section 2.3.8.71. 

0x0001 

The property data is a PT NULL (section 2.3.8.81. 

OxOOOB 

The DroDertv data is a PT BOOLEAN (section 2.3.8.91. 

0x0040 

The DroDertv data is a PT SYSTIME (section 2.3.8.101. 

OxOOOA 

The DroDertv data is a PT ERROR (section 2.3.8.111. 

OxOOlE 

The DroDertv data is a PT STRING8 section 2.3.8.121. 

OxOOlF 

The property data is a PT UNICODE (section 2.3.8.131. 

0x0102 

The DroDertv data is a PT BINARY (section 2.3.8.141. 

OxlOlE 

The DroDertv data is a PT MV STRING8 (section 2.3.8.15^ 

0x1102 

The DroDertv data is a PT MV BINARY (section 2.3.8.161. 


2. 3. 8. 7 PT_LONG 

Referenced by: En vRecipien tPropertvBlob 

A recipient property that is an unsigned integer as specified in rMS-OXCDATAl . 




Value 


o 


Value (4 bytes): The valyg^for this property as specified in [MS-OXCDATA], 

2. 3. 8. 8 

:ferenced by: EnvRecipientPropertvBlob 
A recipient property that is an unsigned integer as specified in rMS-OXCDATAl . 


8 PT_NULL 

renced by: EnvRecioi 
ient ^|||e rt 
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Value 


Value (4 bytes): The value for this property as specified in [MS-OXCDATA], 
2. 3. 8. 9 PT_BOOLEAN 

Referenced by: EnyRecipientPropertyBlob 



2.3.8.11 PT_ERROR 

Referenced by: EnyRecipientPropertyBlob 

A recipient property that is an unsigned integer as specified in rMS-OXCDATAl . 
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Value (4 bytes): The value of the property as specified in [MS-OXCDATA], 
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2.3.8.12 PT_STRING8 


Referenced by: En vRecipientPropertyBlob. PT MV STRING8 

A recipient property that is an ANSI character set string as specified in rMS-OXCDATAl . 


0123456789012345 


6 7 



Size (2 bytes): An unsigned integer that specifies the size, in bytes, of Value. 

Value (variable): An array of characters from the ANSI character set as specified ii 
OXCDATA], 

2.3.8.13 PT_UNICODE 

Referenced by: EnyRecioientProoertyBlob 
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Value (variable) 



Size (2 bytes): An unsigned integer that specifies the size, in bytes, of Value. 
Value (variable): A Unicode string as specified in [MS-OXCDATA], 

2.3.8.14 PT_BINARY 

Referenced by: En vRecipientPropertyBlob. PT MV BINARY 
A recipient property that is an array of Bytes as specified in rMS-OXCDATAl . 
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, 9 ; 

i 

) l 

Size 

Data (variable) 




Size (2 bytes): An unsigned integer that contains the size, in bytes, of Data. 
Data (variable): An array of bytes as specified in [MS-OXCDATA], 
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2.3.8.15 PT_MV_STRING8 


Referenced by: EnvRecipientProoertyBlob 

A recipient property that consists of multiple ANSI character set strings as specified in rMS- 
OXCDATA1 . 

1 2 3 , 

01234567890123456789012345678901 

Count 

Data (variable) 


Count (4 bytes): An unsigned integer that specifies the number of elements in Data. 

Data (variable): An array of PT STRING8 (section 2.3.8.12) as specified in [MS-OXCDATA], 

2.3.8.16 PT_MV_BINARY 

Referenced by: En vRecipientPropertyBlob 



Count (4 bytes): An unsigned integer that specifies the number of elements in Data. 

Data (variable): An array of PT BINARY (section 2.3.8.14) as specified in [MS-OXCDATA], 


2.3.8.17 EnvAttachmentCollection 

Referenced by: MsoEnvelope 

A collection that contains the data for each of the attachments for an email message. 


0 


s. 

4 

5 
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Count 



























Attachments (variable) 
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Count (4 bytes): An unsigned integer that contains the number of attachments for an email 
message. 

Attachments (variable): An array of EnvAttachment (section 2.3.8.18 ) of size Count that 
contains the data for each attachment. 


2.3.8.18 EnvAttachment 

Referenced by: EnvAttachmentCollection 

A structure that contains the data for a single email message attachment. 












1 










2 








3 

0 
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2 

3 

k 

5- 

tit 

7 I 8 I 9 
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AttachmentMethod 


AttachmentNameSize 


AttachmentName (variable) 


AttachmentSizeLowOrderBits 


AttachmentSizeHighOrderBits 

Dffla(vanl™L 



AttachmentMethod (4 bytes): An unsigned integer that represents the MAPI property 
PR_ATTACH_METHOD, as specified in rMS-OXPROPSl . 

AttachmentNameSize (1 byte): A byte that contains the size, in characters, of 

AttachmentName. 

AttachmentName (variable): A Unicode character array that contains the file name of the 
attachment. 

AttachmentSizeLowOrderBits (4 bytes): An unsigned integer that contains the low-order bits 
for the file size of the attachment. 

AttachmentSizeHighOrderBits (4 bytes): An unsigned integer that contains the high-order 
bits for the file size of the attachment. 

lata (variable): An array of bytes that contains the content of the attachment. 

2.3.8.19 IntroText 

ipecifies the text of the introduction for the document when sent as an email message. 
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IntroTextSize 


IntroText (variable) 


IntroTextSize (4 bytes): An unsigned integer that specifies the size, in bytes, of IntroText. 
MUST be evenly divisible by two. 

IntroText (variable): A Unicode character array that specifies the introduction text. 

2.3.9 Document Signature Serialized Certificate Store Structure 

This section specifies a serialized digital certificate store that is persisted as part of a collection of 
document signatures, as specified in rMS-OFFCRYPTOl section 2.5. 


2.3.9. 1 DocSigSerializedCertStore 

The serialized digital certificate store specifies structures for stc 
containing zero or more digital certificates and, optionally, a^ 
certificate. 


(/ 


I certificate store 
associated with each 


12 3 

4 5 6 

7 8 9 

1 

0 1 2 

3 4 Ji 

^ 7 l 8 9 ° 


4 5 6 

3 

7 8 9 0 



irtificateList (variable) 


endMarkerElement 


insigned integer identifying the version of the structure. MUST be 


ileType (4 bytes): An unsigned integer that specifies the type of data contained in the 
structure. MUST be the value 0x54524543. 

certificateList (variable): An array of CertStoreCertificateGroup (section 2.3.2.5.4) . This array 
MAY contain zero or more elements. Each element of the array specifies a digital certificate 
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and a collection of optional properties associated with the certificate. Elements of this array 
are read and processed until a CertStoreCertificateGroup.SerializedPropertyEntry.id is 
read with the unsigned integer value 0x00000000, which specifies the end of this array and 
the beginning of the endMarkerElement field. The terminating 
CertStoreCertificateGroup.SerializedPropertyEntry.id value read is actually the 
endMarkerElement.id field and not part of this field. 

endMarkerElement (12 bytes): An EndElementMarkerEntrv structure (section 2. 3. 2. 5. 2 ) 
specifying the end of the structure. 

2.4 Common Algorithms 

2.4.1 Unicode String to Unsigned Integer Hash 

Given a null-terminated Unicode string, a 4-byte unsigned integer hash value can b. 

performing the following algorithm: 

1. Set a 4-byte unsigned integer value d 

2. Truncate the input string to 255 cha 

3. Convert the input string to lower cas 



4. For each set of 2 characters (Chari, Char2) from position 
example, [0,1], [2,3], [4,5], ..., [255, <null>]) perform the 

Example: 


for ( i==0; i<wcslen (inputstring) ; i+=2) 
Chari = inputstring [i] ; 

Char2 = inputstring [itl] i 


1. Set an unsigned 4-byte integer vali 


bits to the high order and Chari. 

Example: dwNext = (Char2 16) | Chari; 

2. Set dwHash equal to the exclusive OR between dwHash and dwNext. 

Example: dwHash = dwHash A dwNext; 

5. The result of the algorithm is the value dwHash. 

2.4.2 Hyperlink Hash 

Given the two null-terminated Unicode hyperlink strings, hlinkl (hyperlink target) and hlink2 
(hyperlink location), an unsianed 4-bvte inteaer hash can be obtained by performing the following 
alg 



specified in Unicode String to Unsigned LONG Hash (section 2.4.1) . and store the 


ash hlink2 as specified in Unicode String to Unsigned LONG Hash (section 2.4.1) . and store the 
resulting unsigned 4-byte integer hash in dwHash2. 
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3. The result of the algorithm is the value obtained by the exclusive OR of dwHashl and 
dwHash2. 

Example: dwHash = dwHashl A dwHash2; 


2.4.3 MsoCrc32Compute 

The purpose of this algorithm is to calculate a cyclic redundancy check (CRC) checksum. Given a 
data stream, this function computes a 32-bit checksum using the polynomial 
x 32 +x 7 +x 5 +x 3 +x2+x+l. The algorithm uses big-endian bit ordering in a byte (most significant bit 
first). Normal representation for a polynomial is xAF. 

2.4.3. 1 Caching Algorithm 

The caching algorithm is run once and its purpose is to initiate Cache - an array of 256 integers. 



data into substreams and call this subroutine for each of the substreams, passing in the result of the 
CRC computation from the previous substream as CrcValue. 


SUBROUTINE CMCrc^Ml, Arra^ 
CALL Ini^BrcCj^^a ( ) i 

^ch Byt® from 

SET il SBSLt o Cj^PFlus 

ricf^ 24 bits 
usive-OR Index v 
CrcValue left 6 

l CrcValus 

RETURN UPcValue 
D SUBROUTINE 



lith Cache [Index] 
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2.4.4 Date/Time Format from Format Index 

This section specifies the algorithm that produces a date/time format given a format index and an 
LCID that specifies a locale. 

Note: In this section, a string s, which consists of a sequence of the same symbol x, is defined to 
occur in a string t where and only where t contains a sequence of x that is the exact same length as 
s. For example, the substring "dd" occurs in "MM/dd/yyyy" but not in "MM/dddd/yyyy". 

2.4.4. 1 Format Indices 


This section lists and describes the format indices that can be used as inputs to the algorithm. The 
descriptions given are generalized; the actual format produced can vary from the description, 
depending on the input locale. 


Format index 

Format description 

0 

Short date. 

1 

Long date. 

2 

Long date without weekday. 

3 

Alternate short date. 

4 

ISO standard date. 

5 

Short date with abbreviated rrwith. | 

6 

Short date with slashes. 

7 

Alternate short date with abbreviated month. 

8 

English date. 

9 

Month and year. 

10 

Abbreviated month and year. 

11 

Date and 12-hour time. 

12 

Date and 12-hour time with seconds. 

13 

12-hour time. 

14 

12-hcto; time with seconds. 

15 

24-hour time. 

16 

24-hour time with seconds. 

17 

Used for Japanese and Chinese only. 

18 

Used for Chinese only. 

’ll 

Used for Chinese only. 
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2.4.4. 2 Base Format Strings 


This section specifies a set of base strings which are used to generate some formats. The value of 
each string is determined by the system's locale settings (1) for the input locale. 


String name 

Meaning 

Base short 
date 

Specifies a date format which can be used in a context where a short string 
representation of a date is desired. 

Base long 
date 

Specifies a date format which can be used in a context where a detailed string 
representation of a date is desired. 

Base time 

Specifies a time format. 

Time 

separator 

Specifies the symbols which separate minutes from hours or seconds from minutes in a 
string representation of a time. 


2. 4. 4. 3 Retrieve Format 

This section specifies the algorithms used for retrieving the format based on 
section is divided into sections that specify the algorithm for a specific set of 
the format retrieved using an algorithm in this section is not alwayf^e. final 
still subject to format exceptions (section 2.4.4.4j . 

2. 4. 4. 3.1 Chinese Formats 

When the input locale is Chinese, the format is retriev< 



Format index 

Format 

0 

Base short date 

1 

Base long date 

▲ 4[ 

yyyy^M^dBSfflw 

3 

yyyy^M^dB 

4 

yyyy/M/d 

5 

yy.M.d 

6 

yyyy^M^dBMMW 

7 

yyyy^M^da 

8 > ' 

yyyy^MfidBSfflw 

9 

yyyy^M^ 

40 

yyyy^M^ 

m 

hfcfm#s©> 

fiit 7 

hftfm# 

13 

Hftfmtf 
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Format index 

Format 

14 


15 

AMPMhftfm# 

16 

AMPMhftfmtf 

17 

EEEE^O^AB 

18 

EEEE^O^ABMSSW 

19 

EEEE^O^ 


2. 4. 4. 3. 2 Hindi Formats 

When the input locale is Hindi, the format is retrieved from the following lookup table. 


Format index 

Format 

0 

aa/o/g 

1 

dddd, d MMMM yyyy . 

2 

dd MMMM yyyy 

3 

aa/o/gg 

4 

gg-o-aa 

5 

d-MMMM-yyyy 

6 


7 

aa MMMM. gg 

8 

aa MMMM gg 

9 

MMMM YY 

10 

MMMM-g 

11 

aa/o/g r:i 

12 

aa/o/g r:i:c 

13 

r:i am/pm 

14 

r:i:c am/pm 

15 / 

r:i 

16 

r:i:c 


2. 4. 4.3. 3 Japanese Formats 

When the input locale is Japanese, the format is retrieved from the following lookup table. 
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Format index 

Format 

0 

Base short date 

1 

Base long date 

2 

ggge^M^dB(aaa) 

3 

yyyy^M^dB 

4 

yyyy/M/d 

5 

gggE^O^AB 

6 

EE^O^AB(aaa) 

7 

ggge^M^dB 

8 

yyyy^M^dB(aaa) 

9 

ggge^M^ 

10 

yyyy^Mfi 

11 

yy/M/d HBtmtf 

12 

yy/M/d HBtmtfs# 

13 

AMPMh^m^- 

14 

AMPMhftm^s# 

15 


16 


17 

ggge^M^dB aaaBIB 


2. 4. 4. 3. 4 Korean Formats 

When the input locale is Korean, the format is retrieved from the following lookup table. 


Format index 

Format 

0 

Base short date 

1 

Base long date 

2 

yyyytf MS dS aaafiS 

3 

yyyytf MS dS 

4 

yyyy/M/d 

5 

yyMMdd 

6 

gg yyyyti MS dS 

T7 

gg yyyyti MS 
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Format index 

Format 

8 

gg yyyyii MS dS 

9 

gg yyyyy 

10 

yyyyti MS 

11 

yyyy MS dS AMPM hAl mg 

12 

yyii MS dS HAl mg si 

13 

AMPM hAl mg 

14 

AMPM hAl mg si 

15 

HAl mg 

16 

HAl mg Si 


2. 4. 4. 3. 5 Taiwanese Formats 

When the input locale is Taiwanese, the format is retrieved from the following lookup table. 


Format index 

Format 

0 

Base short date 

1 

Base long date 

2 

E^O^AB 

3 

e^M^dB 

4 

EEEE^O^AB 

5 

yyyy^M^da 

6 

E^O^ABSfflW 

7 

e^MfldBIiW 

8 

E^O^ABSSSW 

9 

EE^O^ABMfflW 

10 

EEE^O^ABMSSW 

11 

EEEE^O^ABMMW 

12 

yyyy^M^dBMMW 

13 

yyyy^MfidBMMW 

14 

yyyy^M^dBMfflw 

15 

EE^O^AB 

r\6 

EEE^O^AB 
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2. 4. 4. 3. 6 Thai Formats 

When the input locale is Thai, the format is retrieved from the following lookup table. 


Format index 

Format 

0 

dd/MM/bb 

1 

d 0 0 0 0 "m .0 ." bbbb 

2 

d 0 0 0 0 bbbb 

3 

dd 0 0 0 bb 

4 

dd/MM/bbbb" 

5 

0000 bb 

6 

dd/MM/bb HH:mm "u ." 

7 

dd/MM/bb HH:mm:ss "u ." 

8 

n /0 0 /il il 

9 

Q 0 0 0 0 "w .0 ." ll ll il ll 

10 

i 0000 iJ ddiJ 

11 

0 0 0 ilil 

12 

0000 dll 

13 

Q T /0 0 /ll ll 3 J SJ :u 

14 

q i /0 0 /il il il il in u :vt vi 'u .' 

15 

a u :u v, " v, J 

16 

:*u u :vi vi "u 


2. 4. 4.3. 7 Yi Formats 

When the input locale is Yi, the format is retrieved from the following lookup table. 
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Format index 

Format 

7 

yyyy-MM-dd 

8 

yyyy[0xA20E]M[0xAlAA]d[0xA44D] 

9 

yyyy[0xA20E]M[0xAiAA] 

10 

yyyy[0xA20E]M[0xAlAA] 

11 

yyyy/M/d HH:mm 

12 

yyyy/M/d HH:mm:ss 

13 

h:mm AMPM 

14 

h:mm:ss AMPM 

15 

HH:mm 

16 

HH:mm:ss 


2. 4. 4. 3. 8 Formats for all other Locales 

When the input locale is any other locale, the format is retrieved by following the steps from the row 
in the following table corresponding to the input format index. 


Format 

index 

Format 

0 

Base short date. 

1 

Base long date. 

2 

Do the following to base long date: 

■ Remove occurrences of "dddd". 

■ Remove the comma symiql (0x002C) arid space following "dddd" if present. 

■ Change occurrences of "dd" to "d". 

3 

Do the following to base short date: 

■ Change occurrences of "yyyy" to "yy". 

■ Change occurrences of "yy" to "yyyy". 

4 

yyyy-MM-dd 

5 ^ 

If the Symbol "y" occurs before the symbol "M" occurs in the base short date, the format is 
"yy-MMM-d". Otherwise, the format is "d-MMM-yy". 

6 

klf the forward slash symbol (0x002F) occurs in the base short date, the slash symbol is the 
period symbol (0x002E). Otherwise, the slash symbol is the forward slash (0x002F). 

A group is an uninterrupted sequence of qualified symbols where a qualified symbol is "d", 

"M", or "Y". 

Identify the first three groups that occur in the base short date. The format is formed by 
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Format 

index 

Format 


appending the three groups together with single slash symbols separating the groups. 

7 

Do the following to base long date: 

■ Remove occurrences of "dddd". 

■ Remove the comma symbol (0x002C) and space following "dddd" if present. 

■ Change occurrences of "dd" to "d". 

■ For all right-to-left locales and Lao, change a sequence of any length of "M" to "^&MM’ f . 

■ For all other locales, change a sequence of any length of "M" to "MMM". 

■ Change occurrences of "yyyy" to "yy". 

8 

For American English and Arabic, the format is "d MMMM yyyy". 

For Hebrew, the format is "d MMMM, yyyy". 

For all other locales, the format is the same as format 6 with the following additional step: 
Change occurrences of "yyyy" to "yy". 

9 

Do the following to base long date: 

■ Remove all symbols that occur beforq : the first recurrence of either the "y" symbol or the 
"M" symbol. 

■ Remove all "d" symbols. 

■ For all locales except Lithuanian, rgjj^ye all period symbols (0x002E). 

■ Remove all comma symbols (0^o2C). 

■ Change occurrences of "yyyy" to^yy". 

10 

"MMM-yy". 

11 

Base short date followed by a space, followed by base time with seconds removed. 

Seconds are removed by removinckall "s" symbols and any symbol that directly precedes an 
"s" symbol that is not an "h" or "m" symbol. 

12 

Base short date followed by a space, followed by base time. 

13 

For Hungarian, the format is "am/pm h:mm". 

For all other locales, the format is "h:mm am/pm". 

In both cases, replace occurrences of the colon symbol (0x003A) with the time separator. 

14 

For Hungarian, the format is "am/pm h:mm:ss". 

For all other locales, the format is "h:mm:ss am/pm". 

In both cases, replace occurrences of the colon symbol (0x003A) with the time separator. 


: "HH" followed by the time separator, followed by "mm". 

16 

"HH" followed by the time separator, followed by "mm", followed by the time separator 
followed by "ss". 
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2. 4. 4. 4 Apply Format Exceptions 


This section specifies any exception operations that are performed on a format after it is retrieved. 
The table in each subsection lists all format indices for which an exception operation is to be 
performed for the locale specified by that section. 


2. 4. 4. 4.1 Bokmdl (Norwegian) 


Format index 

Exception operation 

5 

Set format to "d. MMM. yyyy". 

6 

Set format to "d/m yyyy". 

7 

Set format to "MMM. yy". 

8 

Set format to "yyyy.mm.dd". 

10 

Set format to "d. MMM.". 


2. 4. 4. 4. 2 Czech 


Format index 

Exception operation 

9 

Insert "'[0x2019]'" before the last sequence of "y" symbols. 


2. 4. 4. 4. 3 Danish 


Format index 

Exception operation 

1 

Set format to "d. MMMM yyyy". 

2 

Set format to "yy-MM-dd". 

3 

Set format to "yyyy. MM. dd". 

5 

Set format to "MMMM yyyy". 

6 

Set format to "d.M.yy". 

7 

Set format to "d/M yyyy". 

8 

Set format to "dd. MM. yyyy". 

9 

Set format to "d.M.yyyy". 

10 

Set format to "dd/MM yyyy". 


2. 4. 4.4. 4 Dutch 


Format index 

Exception operation 

H 

Insert '"[0x2019]'" before the last sequence of "y" symbols. 
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2. 4. 4. 4. 5 Finnish 


Format index 

Exception operation 

5, 7, 10 

Remove any occurrence of "ta". 

Insert the symbol "k" just after the last occurrence of the symbol "M". 


2. 4. 4. 4. 6 French Canadian 


Format index 

Exception operation 

3 

Set format to "yy MM dd". 


2. 4. 4. 4. 7 German 


Format index 

Exception operation 

5 

Set format to "yy-MM-dd". 

7 

Set format to "dd. MMM. yyyy". 


2. 4. 4. 4. 8 Hungarian 


Format index 

Exception operation 

7 

Set format to "yy. MMM. dd.". 

8 

Set format to '"[0x2019]'yy MMM.". 

9 

Insert "'[0x2019]'" before the last sequence of "y" symbols. 


2. 4. 4.4. 9 Italian 


Format 

index 

Exception operation 

5, 7 

If there is no period symbol (0x002E) following the first sequence of "M" symbols, insert a 
period symbol after the sequence. 

8 

Set format to "MMM. '[0x2019]’yy". 

9 

Insert '"[0x2019]'" before the last sequence of "y" symbols. 


2.4.4.4.10 Japanese 


Format index 

Exception operation 

1 ^ 

Replace any occurrence of "dddd" with "aaaBfH". 

All 

Replace any occurrence of "gg yy" with "gggee". 

Replace any occurrence of "gg y" with "ggge". 
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2.4.4.4.11 Kazakh 


Format index 

Exception operation 

1 

If there are less than four occurrences of the "d" symbol, append ", dddd". 


2.4.4.4.12 Khmer 



134/205 

[MS-OSHARED] - V20120122 
Office Common Data Types and Objects Structures 

Copyright © 2012 Microsoft Corporation. 

Release: Sunday, January 22, 2012 









2.4.4.4.19 Spanish 


Format 

index 

Exception operation 

7 

Replace the word "de" along with any surrounding whitespace and surrounding single quote 
symbols (0x0027) with a single space. 

9 

If "yy" occurs at the end of the format, replace the "yy" with "yyyy". 


2.4.4.4.20 Swedish 


Format index 

Exception operation 

1 

Set format to "dddd 'den 'd MMMM yyyy". 

4 

Set format to "yyMMdd". 

5 

Set format to "d MMM yy". 

6 

Set format to "d/M yyyy". 

7 

Set format to "d MMM -yy". 

8 

Set format to "M/d/yy". 

9 

Set format to "MMMM yyyy". 

10 

Set format to "'den' d MMMM yyyy". 

12 

Set format to "yy-MM-dd hh:mm". 

13 

Set format to "h.mm AM/PM". 

14 

Set format to "h.mm". 


2.4.4.4.21 Tibetan 


Format index 

Exception operation 

1 

If there are less than 4 occurrences of the "d" symbol, append 
"'[Ox200B]'dddd". 

5 

^et format to "yy-M-d". 

7 

Set format to "yyyy. MM. dd". 

10 

Set format to "yyyy.M". 


2.4.4.4.22 Uzbek Cyrillic 


Format index 

Exception operation 

7 

If "MMM." occurs at the end of the format, remove the last period symbol (0x002E). 
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2.4.4.4.23 Vietnamese 


Format index 

Exception operation 

6 

Set format to "d-MMMM-yy". 


2.4.4.4.24 Bhutanese 
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3 Structure Examples 

3.1 Toolbar Customization Examples 


The following subsections contain a series of examples of structures persisted in rMS-DOCl and fMS- 
XLS1 when saving custom toolbars to a file. 

3.1.1 Toolbar Control Example 

This section contains an example for a TBC structure, described in rMS-XLSl section 2.6, 
specifies a modified built-in toolbar control of type Button. The toolbar control was 
Bold toolbar control, but has been modified as follows: 

■ The toolbar control has the string "MyTooltip" set as a ToolTip. 

■ The toolbar control executes the macro called "MySub" when it is clicked. 

■ The toolbar control displays a custom icon. 

Note that a modified toolbar control is not the same as a custom toolbar control. If the toolbar 
control in this example did not execute a macro when clicked, it would still execute the Bold 
command. Custom toolbar controls never save the tbcClientData field to file and always have a 
TCID equal to 0x0001. 

If this example were for a TBC structure, as described in rMS-DOCl section 2.9, then the TBC 
structure would have a field called cid of type Cid, described in rMS-DOCl section 2.9, rather than a 
field called tbcClientData. 


The following table shows the top level representation of a TBC structure, specified in rMS-XLSl 
section 2.6. 


Overview of a TBC structure 

Offset 

Size 

Structure 

Value 

0000006F 

04C^ 

TBC - tbc 


0000006F 

000B 

A: TBCHeader - tbch 


0000007A 

0004 

^^teCCmd - tbcCmd 

0x0004003A 

0000007E 

04B6 

B^reCData - tbcd 




tbc: A TBC structure, described in rMS-XLSl section 2.6. 

tbcCmd: A TBCCmd structure, described in rMS-XLSl section 2.6. Because the toolbar control in 
this example executes a macro when it is clicked, the value of this structure is not used. 




The following table shows the TBCHeader structure (section 2.3.1.10 1 used in this example. 


ew of a TBCHeader structure 

Offset 

0000006F 


Size 

000B 


Structure 

A: TBCHeader - tbch 
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Overview of a TBCHeader structure 

0000006F 

0001 

BYTE - bSignature 

0x03 

00000070 

0001 

BYTE - bVersion 

0x01 

00000071 

0001 

TBCFIaas - bFlaasTCR 

0x00 

00000072 

0001 

BYTE - tct 

0x01 

00000073 

0002 

WORD - tcid 

0x0071 

00000075 

0004 

TBCSFIaas - tbct 

0X00AA0020 

00000079 

0001 

BYTE - bPriority 

0x03 


bSignature: 0x03 specifies the toolbar control signature number. 
bVersion: 0x01 specifies the toolbar control version number. 
bFlagsTCR: Structure of type TBCFIags (section 2.3.1.11) that specif 
tct: 0x01 specifies that this toolbar control is of type Button. 

tcid: 0x0071 specifies TCID for this toolbar control. In the T< 
in rMS-CTXLSl section 2.2, the value 0x0071 corresponds 

tbct: Structure of type TBCSFIags (section 2.3.1.12 ) thal 

bPriority: 0x03 specifies the toolbar control can be 
relative to other toolbar controls in the toolbar. 


The following table shows the TBCData s 



|3.1.13) used in this example. 


Overview of a TBCData structure 

Offset 

Size 

Structure 

0000007E 

04B6 

B: TBCData - tbcd 

0000007E 

0029 

C: TBCGenerallnfo - controlGenerallnfo 

000000A7 

048D 

D: TBCBSpecific - controlSpecificInfo 


<2 


tbcd: A structure of type TBCData (section 2.3.1.13) . 

controlSpecificInfo: Because this is a toolbar control of type Button, this field contains a 
structure of type TBCBSpecific (section 2.3.1.17) . 

The following table shows the TBCGenerallnfo structure (section 2.3.1.14) used in this 
example. 


Overvie 

Offset 


iew of a TBCGenerallnfo structure 


C: TBCGenerallnfo - controlGenerallnfo 
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Overview of a TBCGenerallnfo structure 

0000007E 

0001 

TBCGIFIaa - bFlaas 

0x06 

0000007F 

0001 

WString - descriptionText 


00000080 

0013 

WString - tooltip 


00000093 

0014 

TBCExtralnfo - extrainfo 


00000093 

0001 

WString - wstrHelpFile 


00000094 

0004 

LONG - idHelpContext 

0x000000#^^ 

00000098 

0001 

WString - wstrTag 

jT 

00000099 

000B 

WString - wstrOnAction 


000000A4 

0001 

WString - wstrParam 


000000A5 

0001 

BYTE - tbcu 

0X0, 

000000A6 

0001 

BYTE - tbmg 

0x03^ 


■ In this example the customText field of the TBCGenerallnfo structure (section 2.3.1.141 
does not exist because the bFlags field has a bFlags.fSaveText value equal to 0. 

controlGenerallnfo: A structure of type TBCGenerallnfo (section 2.3.1.14 1. 

descriptionText: This field exists and contains a WString structure (section 2.3.1.41 because 
bFlags.fSaveMiscUIStrings equals 1 in this example. Because this toolbar control does not 
have descriptive text, the cLen field for the WString structure (section 2.3.1.4 1 equals 0x00 
and its data field does not exist. 

tooltip: This field exists and contains a WString structure (section 2.3.1.41 because 
bFlags.fSaveMiscUIStrings equals 1 in this example. The WString structure (section 
2.3.1.41 specifies the string "MyTooltip". 

extrainfo: This field exists and contains a TBCExtralnfo structure (section 2.3.1.161 because 
bFlags.fSaveMiscCustom equals 1 in this example. The TBCExtralnfo structure (section 
2.3.1.161 specifies extrainfomiation saved for this toolbar control. 

extrainfo. wstrHelpFile: This field contains a structure of type WString (section 2.3.1.4 1. 

Because this toolbar control does not have a help file, the cLen field for the WString structure 
(section 2.3.1.4 1 equals 0x00 and its data field does not exist. 

extrainfo. idHelpContext: This field is ignored because this toolbar control does not have a help 

extrainfo. wstrTag: This field contains a structure of type WString (section 2.3.1.41 . Because 
this toolbar control does not have a Tag string, the cLen field for the WString structure 
(section 2.3.1.4 1 equals 0x00 and its data field does not exist. 

xtralnfo.wstrOnAction: This field contains a structure of type WString (section 2.3.1.41 . In 
this example, the toolbar control executes a macro called "MySub". Therefore, this field 
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extrainfo. wstrParam: This field contains a structure of type WString (section 2.3. 1.4 ). The 
cLen field for the WString structure (section 2.3.1.4 ) equals 0x00 and its data field does not 
exist because this toolbar control does not have a Param string. 

extralnfo.tbcu: 0x01 specifies that this toolbar control is applicable when the application is in 
OLE server mode during OLE merging. 

extralnfo.tbmg: Because this toolbar control is not of type Popup, this field is ignored. 

The following table shows the TBCBSpecific structure (section 2.3.1.17) used in this example 


Overview of a TBCBSpecific structure 

Offset 

Size 

Structure 

Value 

000000A7 

0423 

D: TBCBSpecific - controlSpecificInfo 

4 

000000A7 

0001 

TBCBSFIaas - bFlaas 

0x88 

000000A8 

0422 

TBCBitmaD - icon 

V 

000000A8 

0004 

LONG - cbDIB 

0x00000428 

000000AC 

001E 

BITMAPINFOHEADER - biHeader 


000000AC 

0004 

LONG - bData 

^00000028 

000000B0 

0002 

WORD - biWidth 

0x0010 

000000B2 

0002 

WORD - biHeight 

0x0010 

000000B4 

0001 

BYTE - biplanes 

0x01 

000000B5 

0001 

BYTE - biBitCount 

0x20 

000000B6 

0002 

WORD - biCompression 

0x0000 

000000B8 

0002 

WORD - biSizelmage 

0x0000 

000000BA 

00# 

^k^NG - biXPelsPerMeter 

0x00000000 

000000BE 

i|£ 04 ^ 

LONG - biYPelsPerMeter 

0x00000000 

000000C2 


LONG - biCIrUsed 

0x00000000 

000000C6 

0004 

LONG - biCIrlmportant 

0x00000000 

000000CA 


BYTE - bitmapData 


000004CA 

F)06A A 

TBCBitmap - iconMask 



example. 

— 


:ample not 

r simplicity, a detailed explanation of the bFlags and iconMask fields have been omitted. 

■ The iBtnFace of the TBCBSpecific structure (section 2.3.1.17) does not exist because the 

bFlags field has the value bFlags.fCustomBtnFace equal to 0. 

■ The wstrAcc field of the TBCBSpecific structure (section 2.3.1.17) does not exist because 

the bFlags field has the bFlags.fAccelerator equal to 0. 
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■ The biHeader.biBitCount field for the TBCBitmap structure (section 2.3.1.11 contained by 

the icon property of the TBCBSpecific structure (section 2.3.1.171 is greater than 0x08. 
Therefore, the colors array for the TBCBitmap structure (section 2.3.1.11 contained by the 
icon property of the TBCBSpecific structure (section 2.3.1.17 1 does not exist. 

controlSpecificInfo: Structure of type TBCBSpecific (section 2.3.1.171 . 

icon: Structure of type TBCBitmap (section 2.3.1.11 that specifies the bitmap used as the custom 
icon for the toolbar control. A TBCBitmap structure (section 2. 3. 1.1 ) is similar to a 
DevicelndependentBitmap object, described in fMS-WMFl section 2. 2. 2. 9, with the 
following differences: 

■ A TBCBitmap (section 2.3.1.1 1 contains a cbDib field used to calculate the total size of the 

structure. A DevicelndependentBitmap object does not have this field. 

■ The biHeader field of a TBCBitmap (section 2.3.1.11 is of type BITMAPINFO HEADER (section 

2.3.1.21 and has a size of 30 bytes. The BitmapInfoHeader object, described in rMS- 
WMFl section 2. 2. 2. 3, for a DevicelndependentBitmap object has a size of 40 bytes. 

The difference is caused by the following fields: 

■ The biWidth field of a BITMAPINFOHEADER structure (section 2.3.1 ) is 2 bytes in 
size. The Width field of the BitmapInfoHeader object is 4 bytes in size. 

■ The biHeight field of a BITMAPINFOHEADER structure (section 2.3.1.21 is 2 bytes in 
size. The Height field of the BitmapInfoHeader object is 4 bytes in size. 

■ The biPlanes field of a BITMAPINFOHEADER structure (section ^. 3. 1.2 1 is 1 byte in 
size. The Planes field of the BitmapInfoHeader object is 2 bytes in size. 

■ The biBitCount field of a BITMAPINFOHEADER structure (section 2.3.1.21 is 1 byte in 
size. The BitCount field of the BitmapInfoHeader object is 2 bytes in size. 

■ The biCompression field of a BITMAPINFOHEADER structure (section 2.3.1.21 is 2 
bytes in size. The Compression field of the BitmapInfoHeader object is 4 bytes in 
size. 

■ The biSizelmage field of a BITMAPINFOHEADER structure (section 2.3.1.21 is 2 
bytes in size. The ImageSize field of the BitmapInfoHeader object is 4 bytes in 
size. / 

icon.cbDIB: 0x00000428 specifies the total size in bytes of the TBCBitmap structure (section 
2.3.1.11 . excluding this field, plus 10. The total size of the TBCBitmap structure (section 
2.3.1.11 is calculated using the following formula: 

Total Size of TBCBitmap = 

cbDIB - 10 + sizeOf(cbDIB) = 0x000000428 - OxA + 0x4 = 0x000000422 
icon. biHeader: Structure of type BITMAPINFOHEADER (section 2.3.1. 21 . 
icon.biHeader.bData: This field is always equal to 0x00000028. 


oi r.biWidth: 0x0010 specifies the width of the bitmap in pixels, 

oi r. biHeight: 0x0010 specifies the height of the bitmap in pixels. 

icon.biHeader.biPlanes: 0x01 specifies the number of planes for the target device. 
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icon.biHeader.biBitCount: 0x20 specifies the number of bits per pixel. 

icon.biHeader.biCompression: 0x0000 specifies that this is an uncompressed bitmap. Bitmaps 
specified by TBCBitmap (section 2.3.1. 1 ) are always uncompressed. 


icon.biHeader.biSizelmage: 0x0000 because the biCompression field of the 

BITMAPINFOHEADER structure (section 2.3.1.2) equals 0x0000. This field has a value of 
0x0000 and does not specify the size in bytes of the image. 

icon.biHeader.biXPelsPerMeter: The value of this field is 0x00000000 and it is ignored. 

icon.biHeader.biYPelsPerMeter: The value of this field is 0x00000000 and it is ignore' 

icon.biHeader.biCIrUsed: 0x00000000 specifies that this bitmap uses the maximut 
colors corresponding to the value of the biBitCount field. 

icon.biHeader.biCIrlmportant: 0x00000000 specifies that all colors are requirei 
bitmap. 

icon.bitmapData: Array of bytes that contain the actual bitmap data. 
sizeOf(colors) - sizeOf(bi Header) -10 bytes. 



3.1.2 Toolbar Delta Example 

This section contains an example of a TBDelta structure, descril 
specifies a toolbar delta. 

A toolbar delta specifies a change made to a built-in toolbar. In this example, the toolbar delta 
specifies the insertion of a toolbar control at the end of the main menu toolbar. 

For simplicity, the TBC structure, described in rMS-DOCI section 2.9, that specifies the toolbar 
control associated with this TBDelta structure has been omitted. Flowever, the toolbar control in 
this example has the following characteristics: 

■ The toolbar control is a built-in toolbar control of type Button. 

■ The TCID of the toolbar control equals 0x0071. 

The TBC structure associated with this toolbar delta is stored in the rtbdc array of the 
CTBWRAPPER structure, described in rMS-DOCI section 2.9. Flowever, the TBDelta structure 
associated with this toolbar delta is stored in the rCustomizations array of the Customization 
structure, described in rMS-DOCI section 2.9. And, the Customization structure is stored in the 
rCustomizations array of the same CTBWRAPPER structure where the rtbdc array is located. The 
following diagram iiBilrates where the TBC structure associated with the TBDelta structure in this 
example is storec 




< 


ons array of the same 
am illustrates where t 
' 
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rCustomizations 


Customization, 


00000557 

00000559 

0000055D 

^0000561 

.00000565 



Figure 8: Position of a TBC associated wil 


The following table shows the TBDeli 
example. 

Overview of a TBDelta structi 


Cid - cidNext 
Cid - cid 
ULONG - fc 
USHORT - fOnDisk 
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Overview of a TBDelta structure 


00000565 

00000565 


13 bits 
1 bit 


USHORT - iTB 
USHORT - reserved 2 


0x0000 

0x0 


USHORT - fDead 


USHORT - cbTBC 


Example notes: 

■ Due to the simplicity of their values, a detailed explanation for the following fields has been 

omitted: reservedl, fc, fOnDisk, iTB, reserved2, fDead, and cbTBC. 

data: Structure of type TBDelta described in rMS-DOCl section 2.9. 

dopr: 0x0001 specifies that this is an insert operation, which means that a toolbar control has 
been inserted onto the toolbar with an ID equal to the value of the tbidForTBD field of the 
Customization structure, described in rMS-DOCl section 2.9, which contains this structure. 

fAtEnd: 0x0001 specifies that the toolbar control associated with this toolbar delta was inserted 
at the end of the built-in toolbar when the toolbar delta was created. 

ibts: OxOOOA specifies the zero-based index of the toolbar control associated with this toolbar 
delta in the built-in toolbar when the toolbar delta was created. In this example, the toolbar 
control is the eleventh toolbar control. 

cidNext: In this example, cidNext equals OxFFFFFFFF because fAtEnd equals 1. 

cid: Structure of type Cid as described in rMS-DOCl section 2.9, which specifies the command 
identifier of the toolbar control associated with the toolbar delta. 

3.2 Document Summary Information Examples 

This is an example of a Document Summary Information stream as specified in Property Set Storage 
(section 2.3.31 . In this example, the Document Summary Information stream is from a document as 
described in rMS-DOCl . The name of this stream is ”\005DocumentSummaryInformation". The 
contents of this stream from offset 0x0000 to 0x06B7 inclusive are shown in hexadecimal bytes. The 
far-left column is the byte count} 1 the far-right characters are the interpretation of the bytes in the 
ANSI character set. The following sections describe in detail the meaning of portions of this stream. 



00000000: 

00000010: 

00000020: 

00000030: 

0000004Ac 9 

OOOOOtjf' 

000O0M0 

0030007 0 : __ .. .. 

00080: D8 00 00 00 

^OOOO^k^i 00 00 00 
®) 000A0:^^00 00 00 
00 00 
ID 02 00 00 

DC 00 00 00 

IE 00 00 00 



IB 10 
00 00 
00 00 
00 00 
00 00 
11 00 00 00 
0B 00 00 00 
13 00 00 00 
0D 00 00 00 
02 00 00 00 
54 75 74 6F 
0C 00 00 00 


Uv 00 
02 00 
2B 2C 
93 97 
OF 00 
88 00 


B0 00 
DO 00 
E0 00 
F0 00 
00 01 
10 01 
E4 04 
72 69 t 


00 00 
00 00 
F9 AE 
08 00 
00 00 
00 00 
00 00 
00 00 
00 00 
00 00 
00 00 
00 00 
00 00 


6C 

. 75 6C f 


00 00 00 00 
02 D5 CD D5 
44 00 00 00 
2B 2C F9 AE 
01 00 00 00 
0E 00 00 00 
IB 00 00 00 
06 00 00 00 
17 00 00 00 
10 00 00 00 
16 00 00 00 
0C 00 00 00 
IE 00 00 00 
73 00 00 00 
20 44 6F 
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OOOOOOFO 

OOOOOIOO 

00000110 

00000120 

00000130 

00000140 

00000150 

00000160 

00000170 

00000180 

00000190 

000001A0 

000001B0 

000001C0 

000001D0 

000001E0 

000001F0 

00000200 

00000210 

00000220 

00000230 

00000240 

00000250 

00000260 

00000270 

00000280 

00000290: 

000002A0 

000002B0 

000002C0 

000002D0 

000002E0 

000002F0 

00000300 

00000310 

00000320 

00000330 

00000340 

00000350 

00000360 

00000370 

0000038Q: 

00000390: 

000003A0 

000003B0 

oooooacoi 

0000 0300: 
000003E0 
000003B& 
00000400 

oo^cBo 

^ 00^B» 

" 0000430 
0000044^ 
00000450 
*000460 
0000470 
00000480 
00000490 




00 00 00 00 



00 1 eg&f&Sftj 

6B j|. 

56 W 65 jm 

74H0 6 j|p 6 
74wk^T00 

00 l^fcoo 

00 00 05 00 

3A 00 5C 00 
6F 00 66 00 
k5 00 4F 00 
74 00 2E 00 

olRo 01 00 

32 00 03 00 
00 00 03 00 
00 00 68 00 


) 00 00 

. 53 .... PiD LiNKBAS 

' 48 E PID H 

[ 65 LINKS De 

) 0 0 0 0 partment 

! 65 72 .Document number 

65 Approve 

l 69 63 d Critic 

04 alSection 

00 . .A A. 

) 69 00 $ i. 

) 00 00 g 

) 01 00 

) 53 00 y2 S. 

f 6C 00 k.i.p.L.e.v.e.l. 

) 61 00 V.e.r.i.f .i.c.a. 
i '72: 00 t.i.o.n.S.t.a.r. 

) 03 00 t <. . . 

) 03 00 

) 43 00 C. 

J 73 00 : A.M.i.c.r.o.s. 

) 63 00 o.f.t.O.f.f.i.c. 

) 72 00 e.O.r.g.C.h.a.r. 

) IF 00 t. . .v.s.d 

00 y2 d. 

) 00 00 2 

) 1C 00 

) 2F 00 . .h.t.t.p. :././. 
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Q00004A0 


000004C0 

000004D0 

000004E0 

000004F0 

00000500 

D0D0D510 

00000520 

00000530 

00000540 

00000550 

00000560 

00000570 

00000580 

00000590 

000005A0 

000005B0 

000005C0 

000005D0 

000005E0 

000005F0 

00000600 

00000610 

00000620 

00000630 

00000640 

00000650 

00000660 

00000670 

00000680 

00000690 

000006A0 

000006BO 



3.2.1 Document Summary Information Stream Overview 

The following table contains the beginning part of a Document Summary Information stream. There 
are two FilePointers (section 2.2.1. 5! in this section that point to a Document Summary Information 
property set (section 2. 3.3. 2. 2 1 and a User Defined property set (section 2. 3. 3. 2. 31 . respectively. 


Overview of a DocumentSummarylnfoStream 

Offset 

Size 

Structure ^ 

Value 

00000000 

06B8 

PropertySetStream - 

DocumentSummarylnfoStream 


00000000 

0044 

Stream header - PropertySetStream 


00000000 

0002 

WORD - byteOrder 

OxFFFE 

00000002 

|0002 

WORD - version 

0x0000 

00000004 

Hf04 

ProDertvSetSvstemldentifier - svsld 


00000004 

0001 

BYTE - OSMajorVersion 

0x05 
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Overview of a DocumentSummarylnfoStream 

00000005 

0001 

BYTE - OSMinorVersion 

0x01 

00000006 

0002 

WORD - OSType 

0x0002 

00000008 

0010 

GUID - applicationCIsid 

00 00 00 00 00 00 00 00 00 00 00 
00 00 00 00 00 

00000018 

0004 

DWORD - cSections 

0x00000002 

0000001C 

0028 

Array of identifier and offset - 

rgldOffset 


0000001C 

0014 

Identifier and offset - 

IdOffsetElement-1 


0000001C 

0010 

GUID - formatld 

02 D5 CD D5 9C 2E IB 10 93 97 

08 00 2B 2C/9AE 

0000002C 

0004 

FilePointer - sectionOffset 

oxooooJT^ 

00000030 

0014 

Identifier and offset - 

IdOffsetElement-2 


00000030 

0010 

GUID - formatld 

05 D5 CD D5 9C 2E IB 10 93 97 

08 00 2B 2C F9 AE 

00000040 

0004 

FilePointer - sectionOffset 

^0x00000^1^ 

00000044 

0254 

A: PropertySet - 

DocumentSummarylnformation 


00000298 

0420 

B: PropertySet - UserDefinedProperties 



DocumentSummarylnfoStream: This is an example of the PropertySetStream as described 
in rMS-OLEPSl section 2.21. 

PropertySetStream. byteOrder: OxFFFE is a reserved value. 

PropertySetStream. version: 0x0000 is the version number of the property set. 

PropertySetStream. sysId.OSMajorVersion: 0x05 indicates that the major version of the 
operating system that created the file is 5. 

PropertySetStream. sysId.OSMinorVersion: 0x01 indicates that the minor version of the 
operating system that created the file is 1. 

PropertySetStream. sysId.OSType: 0x0002 is a reserved value. 


PropertySetStream.applicationCIsid: 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 is 
CLID_NULL. It is a reserved value. 

'SetStream.cSections: 0x00000002 indicates that this instance of a Document 
Summary Information stream contains two property sets, the Document Summary 
Information property set (section 2.3.3.2.2) and the User Defined property set (section 
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PropertySetStream.rgldOffset.IdOffsetElement-l: The first element in the rgldOffset 

array. 

PropertySetStream.rgldOffset.IdOffsetElement-l.formatld: 02 D5 CD D5 9C 2E IB 10 93 

97 08 00 2B 2C F9 AE is the FMTID_DocSummaryInformation. It indicates that the associated 
sectionOffset points to a Document Summary Information property set (section 2. 3. 3. 2. 2 ). 

PropertySetStream. rgldOffset. IdOffsetElement-l.sectionOffset: 0x00000044 indicates 
that the beginning of the Document Summary Information property set (section 2.3.3.2.2 1 is 
0x00000044 bytes after the beginning of the Document Summary Information stream. In this 
example, DocumentSummarylnfoStream begins at offset 0x00000000. Therefore, the 
Document Summary Information property set (section 2.3.3.2.2^ begins at offset 
0x00000044. See Document Summary Information Property Set Overview (section 3.2.2) for 
an example of this. 

PropertySetStream. rgIdOffset.IdOffsetElement-2: The second element in the rgldOffset 

array. 

PropertySetStream. rgIdOffset.IdOffsetElement-2.formatId: 05 D5 CD D5 9C 2E IB 10 93 

97 08 00 2B 2C F9 AE is the FMTID_UserDefinedProperties. It indicates that the associated 
sectionOffset points to a User Defined property set (section 23JT3).# 

PropertySetStream. rgldOffset. IdOffsetElement-2. sectionOffset: 0x00000298 indicates 
that the beginning of the User Defined property set (section 2.3.3.2.31 is 0x00000298 bytes 
after the beginning of the Document Summary Information stream. In thisexample, 
DocumentSummarylnfoStream begins at offset 0x00000000. Therefore, the User Defined 
property set (section 2. 3. 3. 2. 3 1 begins at offset 0x00000298. See User Defined Property Set 
Overview (section 3.2.3 ) for an example of this. 

3.2.2 Document Summary Information Property Set Overview 


The following table contains the beginning of a Document Sum'nwv Information property set 
(section 2.3.3.2.2^ stream. 


Overview of a DocumentSummarylnformation property set 

Offset 

Size 

Structure 

Value 

00000044 

0254 < 

A: PropertySet - DocumentSummarylnformation 


00000044 

0004 

DWORD - cbSection 

0x00000254 

00000048 

0004 

DWORD - cProps 

0X0000000F 

0000004C 

0078 

Array of PropertyldentifierAndOffset - rg Props 


0000004C 

0008 

PropertyldentifierAndOffset - PidOffsetElement-1 


OOOOO^C 

0004 

DWORD - propld 

0x00000001 

00000050 

0004 

FilePointer - propOffset 

0x00000080 

00000054 

0008 

PropertyldentifierAndOffset - PidOffsetElement-2 


00000054 

0004 

DWORD - propld 

0x00000002 

00000058 

0004 

FilePointer - propOffset 

0x00000088 
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Overview of a DocumentSummarylnformation property set 

0000005C 

0008 

PropertyldentifierAndOffset - PidOffsetElement-3 


0000005C 

0004 

DWORD - propld 

0X0000000E 

00000060 

0004 

FilePointer - propOffset 

0x00000090 

00000064 

0008 

PropertyldentifierAndOffset - PidOffsetElement-4 


00000064 

0004 

DWORD - propld 

0X0000000F 

00000068 

0004 

FilePointer - propOffset 

0X000000B0 

0000006C 

0008 

PropertyldentifierAndOffset - PidOffsetElement-5 


0000006C 

0004 

DWORD - propld 

0X0000001B 

00000070 

0004 

FilePointer - propOffset 

0x00000000 

00000074 

0008 

PropertyldentifierAndOffset - PidOffsetElement-6 


00000074 

0004 

DWORD - propld 

0x00000005 

00000078 

0004 

FilePointer - propOffset 

0X000000D0 

0000007C 

0008 

PropertyldentifierAndOffset - PidOffsetElement-7 


0000007C 

0004 

DWORD - propld 

0x00000006 

00000080 

0004 

FilePointer - propOffset 

0X000000D8 

00000084 

0008 

PropertyldentifierAndOffset - PidOffsetElement-8 


00000084 

0004 

DWORD - propld 

0x00000011 

00000088 

0004 

FilePointer - propOffset 

0X000000E0 

0000008C 

0008 

PropertyldentifierAndOffset - PidOffsetElement-9 


0000008C 

0004 

DWORD - propld 

0x00000017 

00000090 

0004 

FilePointer - propOffset 

0X000000E8 

00000094 

0008 

PropertyldentifierAndOffset - PidOffsetElement-lO 


00000094 

0001a, 

DWORD - propld 

0X0000000B 

00000098 

0004 

FilePointer - propOffset 

0X000000F0 

0000009C 

Qti08 . 

PropertyldentifierAndOffset - PidOffsetElement-11 


0000009C 

0004 

DWORD - propld 

0x00000010 

000000A0 

0004 

FilePointer - propOffset 

0X000000F8 

000000A4 

k0008 

PropertyldentifierAndOffset - PidOffsetElement-12 


000000A4 

0004 

DWORD - propld 

0x00000013 

000000A8 

0004 

FilePointer - propOffset 

0x00000100 
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Overview of a DocumentSummarylnformation property set 

000000AC 

0008 

PropertyldentifierAndOffset - PidOffsetElement-13 


000000AC 

0004 

DWORD - propld 

0x00000016 

000000B0 

0004 

FilePointer - propOffset 

0x00000108 

000000B4 

0008 

PropertyldentifierAndOffset - PidOffsetElement-14 


000000B4 

0004 

DWORD - propld 

0X0000000D 

000000B8 

0004 

FilePointer - propOffset 

0x00000110 

000000BC 

0008 

PropertyldentifierAndOffset - PidOffsetElement-15 


000000BC 

0004 

DWORD - propld 

0X0000000C 

OOOOOOCO 

0004 

FilePointer - propOffset 

0X0000021D 

000000C4 

01D4 

Array of TypedPropertyValue structures - DocSumProperties 



In this table, there is an array of 15 elements, rgProps. Each element in rgProps is a 
PropertyldentifierAndOffset structure ( rMS-OLEPSl section 2.19). Each of these structures 
represents a property that is stored in this Document Summary Information property set (section 

2.3. 3. 2. 2 ) . Each PropertyldentifierAndOffset structure (PidOffsetElement-1 through 
PidOffsetElement-15) contains two fields, propld and propOffset. The propld field indicates the 
property of that element according to PIDDSI (section 2. 3. 3. 2. 2.1) . The propOffset field indicates 
the offset to the Typed PropertyValue ( rMS-OLEPSl section 2.15) structure containing the value of 
the property. 

In this example, some PidOffsetElements share the same structure and therefore are omitted for 
brevity. PidOffsetElement-2 to PidOffsetElement-5 are Lpstr properties (section 2.3.3.1.4) . For 
the structure of an Lpstr property (section 2.3.3. 1.4) . see the Category Property Example (section 

3. 2. 2. 2) . PidOffsetElement-6 to PidOffsetElement-9 are VT_I4 TypedPropertyValue 
properties. For the structure of a VT_I4 TypedPropertyValue property, see the LineCount Property 
Example section 3. 2. 2. 3). PidOffsetElement-lO to PidOffsetElement-13 are VT_BOOL 
TypedPropertyValue properties. For the structure of a VT_BOOL TypedPropertyValue property, 
see the LinksDirtv Property Example (section 3. 2. 2. 4) . 

DocumentSummarylnformation: DocumentSummarylnformation is a property set as 
described in rMS-OLEPSl section 2.20. 

cbSection: 0x00000254 indicates the count of bytes from the beginning of the 

DocumentSummarylnfromation property set (at offset 0x00000044) to the end of the last 
property in the property set ^eadinqPairs (section 3.2.2.6) . at offset 0x00000297 inclusive. 

cProps: OxOOOOOOOF indicates that this Document Summary Information property set (section 
2. 3.3. 2. 2 ) contains OxOOOOOOOF (15) properties. 

s: This is tfie'container of an array of PropertyldentifierAndOffset structures. In this 
le, there are 15 elements, one for each property. 

>ffsetElement-l: CodePage (VT_I2 TypedPropertyValue property). 

rgProps.PidOffsetElement-1. propld: 0x00000001 (GKPIDDSI_CODEPAGE (section 

2. 3. 3.2. 2.1) indicates that there is a CodePage property value at the stream offset indicated 

by propOffset. 
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rgProps.PidOffsetElement-l.propOffset: 0x00000080 indicates that the beginning of the 
CodePage property data is 0x00000080 bytes after the beginning of the Document Summary 
Information property set (section 2.3.3.2.2) . In this example, 

DocumentSummarylnformation begins at offset 0x00000044. Therefore, the CodePage 
property begins at offset 0x000000C4. See the CodePage Property Example (section 3.2.2. I T 

rgProps.PidOffsetElement-2: Category (Lpstr property (section 2.3.3.1.4) ). 

rgProps.PidOffsetElement-2.propId: 0x00000002 (GKPIDDSI_CATEGORY (section 

2.3.3.2.2.1) ) indicates that there is a Category property value at the stream offset indicated 

by propOffset. 

rgProps.PidOffsetElement-2.propOffset: 0x00000088 indicates that the beginning of the 
Category property data is 0x00000088 bytes after the beginning of the Document Summary 
Information property set (section 2.3. 3. 2.2 ). In this example, 

DocumentSummarylnformation begins at offset 0x00000044. Therefore, the Category 
property begins at offset OxOOOOOOCC. See the Category Property Example (secu ^j.2.2.21 . 



rgProps.PidOffsetElement-3: Manager (Lpstr property (section 2. 3. 3.I.' 
rgProps.PidOffsetElement-4: Company (Lpstr property (section 2.3.3. 1. 


rgProps.PidOffsetElement-5: ContentStatus (Lpstr property (section 2. 3. 3.1. T IT 

rgProps.PidOffsetElement-6: LineCount (VT_I4 TypedPropertyValue property). 

rgProps.PidOffsetElement-6.propId: 0x00000005 (GKPIDDSI_LINECOUNT (section 

2. 3. 3. 2. 2.1) indicates that there is a LineCount property value at the stream offset indicated 

by propOffset. 

rgProps.PidOffsetElement-6. propOffset: OxOOOOOODO indicates that the LineCount property 
data is OxOOOOOODO bytes after the beginning of the Document Summary Information 
property set (section 2.3.3.2.2) . In this example, DocumentSummarylnformation begins 
at offset 0x00000044. Therefore, the LineCount property begins at offset 0x00000114. See 
the LineCount Property Example (section 3.2. 2. 3 ). 

rgProps.PidOffsetElement-7: ParagraphCount (VT_I4 TypedPropertyValue property). 
rgProps.PidOffsetElement-8: CountCharsWithSpaces (VT_I4 TypedPropertyValue property). 
rgProps.PidOffsetElement-9: Version (VT_I4 TypedPropertyValue property). 
rgProps.PidOffsetElement-10: Scale (VT_BOOL TypedPropertyValue property). 
rgProps.PidOffsetElement-11: LinksDirty (VT_BOOL TypedPropertyValue property). 

rgProps.PidOffsetElement-ll.propId: 0x00000010 (GKPIDDSI_LINKSDIRTY (section 

2. 3. 3.2. 2.1) ) indicates that there is a LinksDirty property value at the stream offset indicated 

by propOffset. 

rgProps.PidOffsetElement-11. propOffset: 0x000000F8 indicates that the LinksDirty 

property data is 0x000000F8 bytes after the beginning of the Document Summary Information 
property set (section 2. 3.3. 2. 2 ). In this example, DocumentSummarylnformation begins 
at offset 0x00000044. Therefore, the LinksDirty property begins at offset 0x00000013C. See 
the LinksDirty Property Example (section 3. 2. 2. 4 ). 

rgProps.PidOffsetElement-12: SharedDoc (VT_BOOL TypedPropertyValue property). 
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rgProps.PidOffsetElement-13: HyperlinksChanged (VT_BOOL TypedPropertyValue 

property). 

rgProps.PidOffsetElement-14: DocumentParts ( VtVecUnaliqnedLpstr property (section 

2.3.3.1.1cm . 

rgProps.PidOffsetElement-14.propId: OxOOOOOOOD (GKPIDDSI_DOCPARTS (section 

2.3.3.2.2.1) ) indicates that there is a DocumentParts property value at the stream offset 
indicated by propOffset. 

rgProps.PidOffsetElement-14.propOffset: 0x00000110 indicates that the DocumentParts 

property data is 0x00000110 bytes after the beginning of Document Summary Information 
property set (section 2. 3.3.2. 2 ). In this example, DocumentSummarylnformation begins 
at offset 0x00000044. Therefore, the DocumentParts property begins at offset 0x00000154. 
See the DocumentParts Property Example (section 3. 2. 2. 5) . 

rgProps.PidOffsetElement-15: HeadingPairs ( VtVecHeadinqPair property (section 2.3.3.1.10 )). 

rgProps.PidOffsetElement-15.propId: OxOOOOOOOC (GKPIDDSIJHEADINGPAIR (section 
2.3.3.2.2.1) ) indicates that there is a HeadingPairs property value at the stream offs^r 
indicated by propOffset. 

rgProps.PidOffsetElement-15. propOffset: 0x0000021D indicates that the HeadingPairs 

property data is 0x0000021D bytes after the beginning of the Document Summary 
Information property set (section 2.3.3.2.2) . In this example, 
DocumentSummarylnformation begins at offset 0x00000044. Therefore, the 
HeadingPairs property begins at offset 0x00000261. See the HeadingPairs Property Example 
(section 3. 2. 2. 6 ). 

3. 2. 2.1 CodePage Property Example 

This is an example of a CodePage property (VT_I2 TypedPropertyValue property). 


Structure of a CodePage property 

Offset 

Size 

Structure 

Value 

000000C4 

0008 

TypedPropertyValue - GKPIDDSI_CODEPAGE 


000000C4 

00(S| 

WORD - wType 

0x0002 

000000C6 

0002 

WORD - padding 

0x0000 

000000C8 

0002 ... 

WORD - value 

0x04E4 

000000CA 

0002 

WORD - unused 

0x0000 


GKPIDDSI_CODEPAGE: CodePage. 

2 indicates this property is a VT_I2 TypedPropertyValue property (2-byte 

alue: 0x04E4 (1252) indicates the code page used for the property values of the Lpstr (section 
2.3.3. 1.4 ) and UnaliqnedLpstr (section 2. 3. 3. 1.5 ) properties in the Document Summary 
Information property set (section 2. 3. 3. 2.2 ). 
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3. 2. 2. 2 Category Property Example 


This is an example of a Category property ( Lpstr property (section 2.3. 3. 1.4 11. 


Structure of a Category property 

Offset 

Size 

Structure 

Value 

oooooocc 

0014 

TypedPropertyValue - GKPIDDSI_CATEGORY 


oooooocc 

0002 

WORD - wType 

0x00 IE 

000000CE 

0002 

WORD - padding 

0x0000^1 

000000D0 

0010 

Lpstr - stringValue 


000000D0 

0004 

DWORD - cch 

OxOOOOOOOC 

000000D4 

OOOC 

Array of CHAR - value 

^utorian^^ 


GKPIDDSI_CATEGORY: Category. 

wType: OxOOlE indicates that this property is an Lpstr property (section 2.3.3.1.4 1. 

stringValue.cch: OxOOOOOOOC indicates that the count of characters of the Lpstr (section 
2.3.3.1.4 1 value is 12. The value field contains 10 characters (9 for "Tutorials" plus a 
terminating NULL character). There are 2 additional bytes after the terminating NULL 
character which pad the value field to a multiple of 4 bytes. 

stringValue.value: The value of this field is "Tutorials" followed by a null-terminator and 2 
bytes of padding, so the length of this field is OxOOOOOOOC (12). The 2 bytes of padding is 
added to make the length a multiple of 4 bytes. 

3. 2. 2. 3 LineCount Property Example 

This is an example of a LineCount property (VT_I4 TypedPropertyValue property). 


Structure of a LineCount property 

Offset 

Size 

Structure 

Value 

00000114 

0008 

TypedPropertyValue - GKPIDDSI_LINECOUNT 


00000114 

0QQ2- 

WORD - wType 

0x0003 

00000116 

0002 

WORD - padding 

0x0000 

0000011^ 1 

1 0004 

DWORD - value 

OxOOOOOOlF 


G »I_LINECOUNT: LineCount. 

ix0003 indicates that this property is a VT_I4 TypedPropertyValue property (4-byte 



alue: OxOOOOOOlF indicates that the count of lines in the example document is OxOOOOOOlF 
(31). 
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3. 2. 2.4 LinksDirty Property Example 


This is an example of a LinksDirty property (VT_BOOL TypedPropertyValue property). 


Structure of a LinksDirty property 

Offset 

Size 

Structure 

Value 

0000013C 

0008 

TypedPropertyValue - GKPIDDSI_LINKSDIRTY 


0000013C 

0002 

WORD - wType 

OxOOOB 

0000013E 

0002 

WORD - padding 

OxOOOjj^l 

00000140 

0004 

DWORD - value 

0x00000000 



GKPIDDSI_LINKSDIRTY: LinksDirty 

wType: OxOOOB indicates that this property is a VT_BOOL TypedPropert 
if the value field is 0x00000000, or true if it is any other value). 

value: 0x00000000 is the value of the value field of this VT_BOOL TypedPropert 

property, meaning false. This indicates that the linked properties (propld 0x00000006 in the 
UserDefined property set (section 3.2.3) in this example) do not require updating the next 
time the file is opened. 

3. 2. 2. 5 DocumentParts Property Example 

This is an example of a DocumentParts property (Vt\3 
2.3.3.1.10) ). 

The DocumentParts property SHOULD be 
3.2.2.6) because the data in the two are close 
following diagram. 
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LpstrElement-6 


LpstrElement-7 


LpstrE le ment-8 


LpstrElement-9 


property and the HeadingPairs 


Figure 9: Relationship between 
property 

In the figure, the first element of the HeadingPairs property has a headingstring value of "Title", 
meaning it is associated with the title group in the DocumentParts property. The value of the 
headerParts field is 1, meaning there is only 1 element in the DocumentParts property that is in 
the title group, LpstrElement-1. The headingstring of the second element in the HeadingPairs 
property is "Headings", meaning this element is associated with the headings group in the 
DocumentParts property. HeaderParts equals 8, meaning there are 8 elements in the 
DocumentParts property that are in the headings group. They are LpstrElement-2 through 
LpstrElement-9. 


Structure of a DocumentParts property 

Offset 

Size 

Structure 

Value 

00000154 

W0D 

TypedPropertyValue - GKPIDDSI_DOCPARTS 


^00000154 

0002 

WORD - wType 

OxlOlE 
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Structure of a DocumentParts property 

00000156 

0002 

WORD - padding 

0x0000 

00000158 

0109 

VtVeclInalianedLDStrValue - UnalianedLDStr 

Vector 


00000158 

0004 

DWORD - cElements 

0x00000009 

0000015C 

0105 

Array of UnalignedLpstr - rgString 


0000015C 

0020 

UnalianedLDStr - LostrElement-1 


0000015C 

0004 

DWORD - cch 

OxOOOOOOlC 

00000160 

001C 

Array of CHAR - value 

Invoice Approval 

Procedures 

0000017C 

0017 

UnalignedLpstr - LpstrElement-2 


0000017C 

0004 

DWORD - cch 

0x00000013 

00000180 

0013 

Array of CHAR - value 

Approval Procedure 

00000193 

0019 

UnalignedLpstr - LpstrElement-3 


00000193 

0004 

DWORD - cch 

o^ooo’MT 

00000197 

0015 

Array of CHAR - value 

Manager Approval 

000001AC 

001C 

UnalignedLpstr - LpstrElement-4 


000001AC 

0004 

DWORD - cch 

0x00000018 

000001B0 

0018 

Array of CHAR - value 

Skip-level Approval 

000001C8 

0021 

UnalignedLpstr - LpstrElement-5 


000001C8 

0004 

DWORD - cch 

OxOOOOOOlD 

000001CC 

001D 

Array of CHAR - value 

Organizational Chart 

000001E9 

0024 

UnalignedLpstr - LpstrElement-6 


000001E9 

0004 

DWORD - cch 

0x00000020 

000001ED 

002^ 

Array of CHAR - value 

Skip-level verification 

0000020D 

0017 

UnalignedLpstr - LpstrElement-7 


0000020^ 

0004 

M DWORD - cch 

0x00000013 

00000211 

0013 

Array of CHAR - value 

Verification Steps 

00000224 

001D 

UnalignedLpstr - LpstrElement-8 


00000224 

|goo4 

DWORD - cch 

0x00000019 

00000228 

0019 

Array of CHAR - value 

Manager Verification 

00000241 

0020 

UnalignedLpstr - LpstrElement-9 
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Structure of a DocumentParts property 

00000241 

0004 

DWORD - cch 

0x000000 1C 

00000245 

001C 

Array of CHAR - value 

Skip-level Verification 


In this example, the LpstrElements share the same structure. For brevity, only one of them is 
explained in the following section. LpstrElement-2 is explained because it is more representative i. 
the calculation of count of bytes. 

GKPIDDSI_DOCPARTS: DocumentParts. 

wType: OxlOlE indicates this property value is an array of single-byte character strini 
case of DocumentParts this indicates the property is a VtVecUnalignedLpstr prop* 

(section 2.3.3.1.101 . 

UnalignedLpstr Vector.cElements: 0x00000009 indicates there are 9 element 
VtVecUnalignedLpstr (section 2.3.3.1.10) . 

UnalignedLpstr Vector.rgString.LpstrElement-2: The second UnalignedLpsti Dn 

2.3.3.1.5) in this vector. 

UnalignedLpstr Vector.rgString.LpstrElement-2.cch: 0x00000013 (19) is the count of bytes 
of the value field of the UnalignedLpstr (section 2. 3. 3. 1.5 ) ("Approval Procedure" followed by 
a terminating NULL character). The UnalignedLpstr (section 2.3.3.1.51 structure does not 
require padding. Therefore, in this example, even though 19 is not a multiple of 4 bytes, no 
padding is added to the value field. 

UnalignedLpstr Vector.rgString.LpstrElement-2. value: "Approval Procedure" is the value of 
the value field of this UnalignedLpstr (secti on 2.3.3. 1.5) . 

The rest of the UnalignedLpstr (section 2.3.3. 1.5) structures in this example have the same 
format as the Vector.rgString.LpstrElement-2 structure defined previous. 



3. 2. 2. 6 HeadingPairs Property Example 

This is an example of a HeadingPairs property ( VtVecHeadinqPair property (section 2. 3.3.1. 15 )). 


Structure of a Headini 

gPairs property 

Offset 

Size 

Structure 

Value 

00000261 

003^ 

Typed PropertyValue - GKPIDDSI_HEADINGPAIR 


00000261 

0002 

WORD - wType 

OxlOOC 

00000263, 

0002 

WORD - padding 

0x0000 

00000265 

0033 

VtVecHeadinaPairValue - GKPIDDSI HEADINGPAIR 


00000265 

0004 

DWORD - cElements 

0x00000004 

00000269 

. 002F 

Array of VtHeadingPair - rgHeadingPairs 


00000269 

^016 

VtHeadinqPa - VtHeadinqPairElement-1 


^00000269 

000E 

VtUnalianedStrina - headinaStrina 
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Structure of a HeadingPairs property 

00000269 

0002 

WORD - stringType 

OxOOlE 

0000026B 

0002 

WORD - padding 

0x0000 

0000026D 

000A 

UnalianedLDStr - strinaValue 


0000026D 

0004 

DWORD - cch 

0x00000006 

00000271 

0006 

Array of CHAR - value 

Title 

00000277 

0008 

TypedPropertyValue - headerParts 


00000277 

0002 

WORD - wType 

0x^63 

00000279 

0002 

WORD - padding 

0x0000 

0000027B 

0004 

DWORD - value 

0x00000001 

0000027F 

0019 

VtHeadingPair - VtHeadingPairElement-2 


0000027F 

0011 

VtUnalignedString - headingstring 


0000027F 

0002 

WORD - stringType 

0x00 IE 

00000281 

0002 

WORD - padding 

0x0000 

00000283 

000D 

UnalignedLpstr - stringValue 


00000283 

0004 

DWORD - cch 

0x00000009 

00000287 

0009 

Array of CHAR - value 

Headings 

00000290 

0008 

TypedPropertyValue - headerParts 


00000290 

0002 

WORD - wType 

0x0003 

00000292 

0002 

^jj&D - padding 

0x0000 

00000294 

0004 

DWORD - value 

0x00000008 


GK 

K 


The HeadingPairs property needs to be viewed together with the DocumentParts property (section 

3.2.2.5) . because data in the two are closely related. See the DocumentParts property (section 

3.2.2.5) example for more explanation. 

wType: OxlOOC indicates this property is a vector of variant types. 

GKPIDDSI_HEADINGPAIR.cElements: 0x00000004 indicates there are two elements in 

rgHeadingPairs. cElements is always twice the number of elements in rgHeadingPairs 
because each VtHeadingPair (section 2.3.3.1.13 ) element contains two values, 

headingstring and headerParts. 

:PIDDSI_HEADINGPAIR.rgHeadingPairs: This is a container of the array of VtHeadingPair 
(section 2.3.3.1.13) . 

KPIDDSI_HEADINGPAIR.rg Heading Pairs. VtHeadingPair Element- 1: The first 
VtHeadingPair (section 2.3.3.1.13) in this array. This maps to LpstrElement-1 of the table 
labeled "Structure of a DocumentParts property" in section 3.2.2.5. in the DocumentParts 
property. 
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GKPIDDSI_HEADINGPAIR.rgHeadingPairs.VtHeadingPairElement-l. headingstring: The 
headingstring in this VtHeadingPair (section 2.3.3.1.13) element is an UnalignedLpstr 
(section 2.3.3.1.5) structure. The value field of this structure is "Title" and indicates that the 
associated group in the DocumentParts property contains the title of this document. 

GKPIDDSI_HEADINGPAIR.rgHeadingPairs.VtHeadingPairElement-l.headerParts: The 
headingParts of this headingPair is a VT_I4 TypedPropertyValue property. The value of it 
is 0x00000001, meaning this headingPair is associated with 1 element in the 
DocumentParts property. 

GKPIDDSI_HEADINGPAIR.rgHeadingPairs.VtHeadingPairElement-2: This is the second 
VtHeadingPair (section 2.3.3.1.13) element in this vector. It conforms to the same structure 
as the first element but contains different data. The value field of headingstring is 
"Headings", indicating that the associated elements in the DocumentParts property specify 
the heading of the document. The value field of the headerParts has a value of 8, meaning 
there are eight elements of UnalignedLpstr (section 2.3.3.1.5) structure in the 
DocumentParts property associated with VtHeadingPairElement-2. They are 
LpstrElement-2 through to LpstrElement-9 of the table labeled "Structure of a 
DocumentParts property" in section 3. 2. 2. 5 , in the DocumentParts property. 

3.2.3 User Defined Property Set Overview 

The following table contains the beginning of a User Defined property set (section 2.3.3. 2. 3) . In this 
table, there is an array, rgUserProps. Each element in rgUserProps is a 

PropertyldentifierAndOffset structure ( rMS-OLEPSI section 2.19). The structure of this section of 
the User Defined property set (section 2. 3. 3. 2. 3 ) is similar to that described in Document Summary 
Information Property Set Overview (section 3.2.2) . The major difference is that in the User Defined 
property set (section 2. 3. 3. 2. 3 ) most propld values do not have a meaning defined by this 
specification, but instead have a meaning defined by their names as found in the Dictionary property 
(section 3.2.3.1 1. 


Overview of a User Defined property set 

Offset 

Size 

Structure 

Value 

00000298 

0420 

B: PropertySet - UserDefinedProperties 


00000298 

0004 

DWORD - cbSection 

0x00000420 

0000029C 

0004 

DWORD - cProps 

0x00000009 

000002A0 

0048 

Array of PropertyldentifierAndOffset - rgUserProps 


000002A0 


PropertyldentifierAndOffset - PidOffsetElement-1 


000002A0 

0004 

DWORD - propld 

0x00000000 

000002A4 

0004 

FilePointer - dictionaryOffset 

0x00000050 

000002A8 

0008 

PropertyldentifierAndOffset - PidOffsetElement-2 


| oooodap K 

0004 

DWORD - propld 

0x00000001 

000002AC 

0004 

FilePointer - codepageOffset 

0X000000D2 

000002B0 

0008 

PropertyldentifierAndOffset - PidOffsetElement-3 


000002B0 

0004 

DWORD - propld 

0x00000002 


159 / 205 

[MS-OSHARED] - V20120122 
Office Common Data Types and Objects Structures 

Copyright © 2012 Microsoft Corporation. 

Release: Sunday, January 22, 2012 


Overview of a User Defined property set 

000002B4 

0004 

FilePointer - linkbaseOffset 

OxOOOOOODA 

000002B8 

0008 

PropertyldentifierAndOffset - PidOffsetElement-4 


000002B8 

0004 

DWORD - propld 

0x00000003 

000002BC 

0004 

FilePointer - hyperlinksOffset 

0x000000E6 

000002C0 

0008 

PropertyldentifierAndOffset - PidOffsetElement-5 


000002C0 

0004 

DWORD - propld 

0x00000004 

000002C4 

0004 

FilePointer - propOffset 

Ox0p(3O3B6 """ 

000002C8 

0008 

PropertyldentifierAndOffset - PidOffsetElement-6 


000002C8 

0004 

DWORD - propld 

0x00000005 

000002CC 

0004 

FilePointer - propOffset 

0X000003CA 

000002D0 

0008 

PropertyldentifierAndOffset - PidOffsetElement-7 


000002D0 

0004 

DWORD - propld 

0x00000006 

000002D4 

0004 

FilePointer - propOffset 

' 0X000003D2 

000002D8 

0008 

PropertyldentifierAndOffset - PidOffsetElement-8 


000002D8 

0004 

DWORD - propld 

0x00000007 

000002DC 

0004 

FilePointer - propOffset 

0x000003DA 

000002E0 

0008 

PropertyldentifierAndOffset - PidOffsetElement-9 


000002E0 

0004 

DWORD - propld 

0x01000007 

000002E4 

0004 

FilePaifUr - propLinkOffset 

0X000003FA 

000002E8 

03D0 

Array of propMes - UserDefinedProperties 



UserDefinedProperties: UserDefinedProperties is a PropertySet as detailed in rMS-OLEPSl 

section 2.20. 


cbSection: 0x00000420 indicates the count of bytes from the beginning of the 

UserDefinedProperties property set (0x00000298) to the end of the last property in the 
property set, the CriticalSection Link property (section 3. 2. 3. 4 ). If the size is calculated as 
0x0000069A + OxOOlC - 0x00000298, it actually results in a size of 0x0000041E instead of 
0x00000420. This is because the property set is padded to a multiple of 4 bytes. After the end 
of the CriticalSection_Link property (section 3.2. 3. 4) property, there are 2 bytes of padding to 
make the count of bytes of the property set a multiple of 4 bytes, resulting in a length of 
0x00000420. 

rops: 0x00000009 indicates that this User Defined property set (section 2. 3. 3. 2. 3 ) contains 
nine properties. 

rgUserProps: This is the container of an array of PropertyldentifierAndOffset structures. In 
this example, there are nine elements, one for each property. 
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rgUserProps.PidOffsetElement-1: Dictionary (Dictionary property). 

rgUserProps.PidOffsetElement-l.propId: 0x00000000 indicates that there is a Dictionary 

property value at the stream offset indicated by the dictionaryOffset value. 


rgUserProps.PidOffsetElement-l.dictionaryOffset: 0x00000050 indicates that the beginning 
of the Dictionary property data is 0x00000050 bytes after the beginning of the 
UserDefinedProperties property set (0x00000298). In this example, the Dictionary 
property begins at offset 0x000002E8. See the Dictionary property example (section 3.2.3. 1 ). 

rgUserProps.PidOffsetElement-2: CodePage (VT_I2 TypedPropertyValue property). 

rgUserProps.PidOffsetElement-2.propId: 0x00000001 indicates that there is a CodePage 

property value at the stream offset indicated by the codepageOffset value. 

rgUserProps.PidOffsetElement-2.codepageOffset: OxOOOOOOD2 indicates that the beginning 
of the CodePage property data is 0x000000D2 bytes after the beginning of the 
UserDefinedProperties property set. 

rgUserProps.PidOffsetElement-3: User-defined property. 

rgUserProps.PidOffsetElement-3.propId: 0x00000002 indicates there is a user-defined 
property value at the stream offset indicated by the linkbaseOffset value. The name of this 
user-defined property is specified in the Dictionary property as "_PID_LINKBASE". See the 
Dictionary Property Example (section 3.2.3.1) . 

rgUserProps.PidOffsetElement-3. linkbaseOffset: OxOOOOOODA indicates the user-defined 
property with propld 0x00000002 begins OxOOOOOODA bytes after the beginning of the 
UserDefinedProperties property set. In this example, this property begins at offset 
0x00000372. See the LinkBase Property Example (^^kpn 3.^^fcT 

rgUserProps.PidOffsetElement-4: User-defined property. 

rgUserProps.PidOffsetElement-4. propld: 0x00000003 indicates there is a user-defined 
property value at the stream offset indicate! 


this user-defined property is specified ini 
Dictionary Property Example (section 3.2.: 


id by the hyperlinksOffset value. The name of 
ictionary property as "_PID_HLINKS". See the 


rgUserProps.PidOffsetElement-4. hyperlinksOffset: 0x000000E6 indicates the user-defined 
property with propld 0x00000003 begins 0x000000E6 bytes after the beginning of the 
UserDefinedProperties property set. In this example, this property begins at offset 
0x0000037E. See the Hyperlinks Property Example (section 3. 2. 3. 3) . 

rgUserProps.PidOffsetElement-5: User-defined property. 


rgUserProps.PidOffsetElement-5. propld: 0x00000004 indicates there is a user-defined 
property value at the stream offset indicated by the propOffset value. The name of this user- 
defined property is specified in the Dictionary property as "Department". See the Dictionary 
Property Example (section 3.2.3. 1 ). 

rgUserProps.PidOffsetElement-5. propOffset: 0x000003B6 indicates the user-defined 
property with propld 0x00000004 begins 0x000003B6 bytes after the beginning of the 
UserDefinedProperties property set. This property is a Lpstr (section 2.3.3.1.4) property, 
see Category Property Example (section 3. 2. 2. 2 ) for an example of a Lpstr (section 2. 3. 3. 1.4 ) 
property. 

rgUserProps.PidOffsetElement-6: User-defined property. 
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rgUserProps.PidOffsetElement-6.propId: 0x00000005 indicates there is a user-defined 

property value at the stream offset indicated by the propOffset value. The name of this user- 
defined property is specified in the Dictionary property as "Document number". See the 
Dictionary Property Example (section 3.2.3. I T 

rgUserProps.PidOffsetElement-6. propOffset: 0x000003CA indicates the user-defined 
property with propld 0x00000005 begins 0x000003CA bytes after the beginning of the 
UserDefinedProperties property set. This property is a VT_I4 TypedPropertyValue 
property. See the LineCount Property Example (section 3. 2. 2. 3) for an example of a VT_I4 

TypedPropertyValue property. 

rgUserProps.PidOffsetElement-7: User-defined property. 

rgUserProps.PidOffsetElement-7. propld: 0x00000006 indicates there is a user-defined 

property value at the stream offset indicated by the propOffset value. The name of this user- 
defined property is specified in the Dictionary property as "Approved". See the Dictionary 
Property Example (section 3.2.3.1V 

rgUserProps.PidOffsetElement-7. propOffset: 0x000003D2 indicates the user-defined 
property with propld 0x00000006 begins 0x000003D2 bytes after the beginning of the 
UserDefinedProperties property set. This property is a VT_BOOL TypedPropertyValue 
property. See the LinksDirtv Property Example (section 3.2.2.4 ) for an example of a VT_BOOL 

TypedPropertyValue property. 

rgUserProps.PidOffsetElement-8: User-defined linked property. 

rgUserProps.PidOffsetElement-8.propId: 0x00000007 indicates there is a user-defined 

property value at the stream offset indicated by the propOffset value. The name of this user- 
defined property is specified in the Dictionary property as "CriticalSection". See the 
Dictionary property example (section 3.2.3.1V 

rgUserProps.PidOffsetElement-8.propOffset: 0x000003DA indicates the user-defined 
property with propld 0x00000007 begins 0x000003DA bytes after the beginning of the 
UserDefinedProperties property set. In this example, this property begins at offset 
0x00000672. See the Linked Property Example (section 3.2.3.4V 

rgUserProps.PidOffsetElement-9: User-defined Link. 

rgUserProps.PidOffsetElement-9. propld: 0x01000007 indicates that the user-defined 
property in this property set with propld 0x01000007 is linked to document content. This 
user-defined Link value is at the stream offset indicated by the propLinkOffset value. See 
the Linked Property Example (section 3.2.3.4 V 

rgUserProps.PidOffsetElement-9. propLinkOffset: 0x000003FA indicates that the user- 
defined property link with propld 0x10000007 begins 0x000003FA bytes after the beginning 
of the UserDefinedProperties property set. In this example, this property begins at offset 
0x00000692. See the Linked Property Example (section 3.2.3.4V 

3.2.3. 1 Dictionary Property Example 

This is an example of a Dictionary property as detailed in IS-OLEPS1 section 2.17. This property 
gives a mapping between propertyld and propertyName for the User Defined property set 
(section 2.3.3.2.3V except for the Dictionary property, the CodePage property, and the Links 
(section 3.2.3.4 V In this example, there are 9 elements in the array of 

PropertyldentifierAndOffset (rgUserProps of the previous table). Each element represents a 
property. However there are only 6 DictionaryEntry elements ( rMS-OLEPSl section 2.16) in the 
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rgEntries in the Dictionary property of following table. The 3 elements that are excluded are the 
element associated with the Dictionary property (PidOffsetElement-1 in rgUserProps), the 
element associated with the CodePage property (PidOffsetElement-2 in rgUserProps), and the 
element associated with the property link (PidOffsetElement-9 in rgUserProps). 


Structure of a Dictionary property 

Offset 

Size 

Structure 

Value 

000002E8 

0082 

Dictionary - Dictionary 


000002E8 

0004 

DWORD - cEntries 

0x00000006 

000002EC 

007E 

Array of DictionaryEntry - rgEntries 


000002EC 

0016 

DictionaryEntry - LpstrNameldElement-l 


000002EC 

0004 

DWORD - property Id 

OxOOOOOOOl'T 

000002F0 

0012 

UnalianedLDStr - DrooertvName 


000002F0 

0004 

DWORD - cch 

0X0000000E 

000002F4 

000E 

Array of CHAR - value 

fliffi D-I-mIbas e 

00000302 

0014 

DictionaryEntry - LpstrNameIdElement-2 


00000302 

0004 

DWORD - propertyld 

|px00000003 

00000306 

0010 

UnalignedLpstr - propertyName 


00000306 

0004 

DWORD - cch 

oxoooooooc 

0000030A 

oooc 

Array of CHAR - value 

_PID_H LINKS 

00000316 

0013 

DictionaryEntry - LpstrNameIdElement-3 


00000316 

0004 

DWORD - propertyld 

0x00000004 

0000031A 

000F 

UnalignedLpstr - propertyName 


0000031A 

0004 

DWORD - cch 

0X0000000B 

0000031E 

000B 

Array of CHAR - value 

Department 

00000329 

0018 

DictionaryEntry - LpstrNameIdElement-4 


00000329 

0004 

DWORD - propertyld 

0x00000005 

0000032D 

001 Ji 

UnalignedLpstr - propertyName 


00000|§F 

0004 

DWORD - cch 

0x00000010 

00000331 

0010 

Array of CHAR - value 

Document number 

00000341 

0011 

DictionaryEntry - LpstrNameIdElement-5 


00000341 

0004 

DWORD - propertyld 

0x00000006 

00000345 

000D 

UnalignedLpstr - propertyName 
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Structure of a Dictionary property 

00000345 

0004 

DWORD - cch 

0x00000009 

00000349 

0009 

Array of CHAR - value 

Approved 

00000352 

0018 

DictionaryEntry - LpstrNameIdElement-6 


00000352 

0004 

DWORD - property Id 

0x00000007 

00000356 

0014 

UnalignedLpstr - propertyName 


00000356 

0004 

DWORD - cch 

0x00000010 

0000035A 

0010 

Array of CHAR - value 

CriticalSe<^0n 


cEntries: 0x00000006 indicates there are six entries in rgEntries. 

rgEntries: This is an array of DictionaryEntry. The CodePage property value in 

UserDefinedProperties is not CP_WINUNICODE (0x04B0) so each DictionaryEntry 

contains an UnalignedLpstr (section 2.3.3. 1.5) . see rMS-OLEPSl section 2 

rgEntries. LpstrNameldElement-l: This is the first element in this array. 

rgEntries.LpstrNameldElement-l.propertyld: 0x00000002 is the same as one of the propld 

elements in rgUserProps, which indicates that this DictionaryEntry corresponds to the 
user-defined property with propld 0x00000002. 

rgEntries.LpstrNameldElement-l.propertyName: This is an UnalignedLpstr (section 

2.3. 3.1.5 ) structure. 

rgEntries.LpstrNameldElement-l.propertyName.cch: OxOOOOOOOE is the count of character 
value for this UnalignedLpstr (section 2.3.3. 1.5) structure. The cch field in 
LpstrNameldElement-l to LpstrNameIdElement-6 is the count of character value for 
each of the UnalignedLpstr structures. See the DocumentParts Property Example (section 

3.2.2.5) for the structure of an UnalignedLpstr. 

rgEntries.LpstrNameldElement-l.propertyName. value: "_PID_LINKBASE" indicates the 
property name of the user-defined property with propld 0x00000002. See the LinkBase 
Property Example (section 3.2. 3. 2 ). 

rgEntries. LpstrNameIdElement-2: This is the second element in this array. 

rgEntries.LpstrNameIdElement-2.propertyId: 0x00000003 is the same as one of the propld 

elements in rgUserProps, which indicates that this DictionaryEntry corresponds to the 
user-defined property with propld 0x00000003. 

rgEntries.LpstrNameIdElement-2.propertyName: This is an UnalignedLpstr (section 

3.1.5 ) structure. 


1 , 



ies.LpstrNameIdElement-2.propertyName. value: "_PID_HLINKS" indicates the 
:rty name of the user-defined property with propld 0x00000003. See the Hyperlinks 
Property Example (section 3. 2. 3. 3 ). 

itrNameIdElement-3: This is the third element in this array. 
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rgEntries.LpstrNameIdElement-3.propertyId: 0x00000004 is the same as one of the propld 

elements in rgUserProps, which indicates that this DictionaryEntry corresponds to the 
user-defined property with propld 0x00000004. 


rgEntries.LpstrNameIdElement-3.propertyName: This is an UnalignedLpstr (section 
2.3.3. 1.5 ) structure. 


rgEntries.LpstrNameIdElement-3.propertyName. value: "Department" indicates the 
property name of the user-defined property with propld 0x00000004. 

rgEntries.LpstrNameIdElement-4: This is the fourth element in this array. 

rgEntries.LpstrNameIdElement-4.propertyId: 0x00000005 is the same as one of |h 

elements in rgUserProps, which indicates that this DictionaryEntry correspondin' tl 
user-defined property with propld 0x00000005. 

rgEntries.LpstrNameIdElement-4.propertyName: This is an UnalignedLpstr i 
2.3. 3.1.5 ) structure. 

rgEntries.LpstrNameIdElement-4. property Name, value: "Docum 
property name of the user-defined property with propld 0x00000( 

rgEntries.LpstrNameIdElement-5: This is the fifth element Mathis . 

rgEntries. LpstrNa meld Element-5, propertyld: 0x000001 
elements in rgUserProps, which indicates that this Dicti 
user-defined property with propld 0x00000006. 

rgEntries.LpstrNameIdElement-5.propertyName: This is the container for an UnalignedLpstr 
(section 2.3.3.1.5) structure. 



e of the propld 

corresponds to the 


rgEntries.LpstrNameIdElement-5.propertyName. value: "Approved" indicates the property 
name of the user-defined property with propld 0x00000006. 

rgEntries.LpstrNameIdElement-6: This is the sixth element in this array. 

rgEntries.LpstrNameIdElement-6.propertyId: 0x00000007 is the same as one of the propld 

elements in rgUserProps, which indicates that this DictionaryEntry corresponds to the 
user-defined property with propld 0x00000007. 

rgEntries.LpstrNameIdElement-6.propertyName: This is an UnalignedLpstr (section 
2.3.3.1.5) structure. 


rgEntries.LpstrNameIdElement-6.propertyName. value: "CriticalSection" indicates the 
property name of the user-defined property with propld 0x00000007. See the Linked 
Property Example (section 3. 2. 3. 4 ). 


3. 2. 3. 2 LinkBase Property Example 

This is an example of the LinkBase property (VT_BLOB TypedPropertyValue property). 


Structure of a LinkBase property 

Offset 

Size 

Structure 

Value 

^0000372 

000A 

TypedPropertyValue - _PID_LIN XBASE 
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Structure of a LinkBase property 

00000372 

0002 

WORD - wType 

0x0041 

00000374 

0002 

WORD - padding 

0x0000 

00000376 

0004 

DWORD - cb 

0x00000002 

0000037A 

0002 

Array of WCHAR - value 

0x0000 

0000037C 

0002 

Array of bytes - padding 

0x0000 


wType: 0x0041 indicates the property is a VT_BLOB TypedPropertyValue property. 

cb: 0x00000002 indicates the count of bytes of the value of this property. In this example, the 
value field contains an empty string, so 0x00000002 refers to the count of bytes of the 
Unicode terminating NULL character. 

value: The value field of the property contains only a Unicode terminating NULL character. 

padding: 0x0000 is 2 bytes of padding. This padding is added so that the length of this VT_BLOB 
TypedPropertyValue property structure is a multiple of 4 bytes. 

3. 2. 3. 3 Hyperlinks Property Example 


This is an example of a VtHyperlinks property (section 2.3.3.1.21 T There is a rgHyperlink vector in 
the property, which contains all the hyperlinks within this sample document. 


Structure of a Hyperlinks property 

Offset 

Size 

Structure 

Value 

0000037E 

02D0 

VtHyperlinks - _PID_HLINKS 


0000037E 

0002 

WORD - wType 

0x0041 

00000380 

0002 

WORD - padding 

0x0000 

00000382 

02CC 

VtHvDerlinkValue - vtValue 


00000382 

0004 

DWORD - cbData 

0x00000208 

00000386 

02C8 

Vec\?fH%p,erlink - vecHvDerlink 


00000386 

0004 

. \DWORD - cElements 

0x00000024 

0000038A 

fo2C4^ 

Array of VtHyperlink - rgHyperlink 


0000038^. ’ 

Q06C 

VtHvDerlink - linkElement-1 


000003F6 

0074 

VtHyperlink - linkElement-2 


0000046A 

006C 

VtHyperlink - linkElement-3 


000004D6 

005C 

VtHyperlink - linkElement-4 


1^)000532 ^ 

00B4 

VtHyperlink - linkElement-5 


k 000005E6 

0068 

VtHyperlink - linkElement-6 
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wType: 0x0041 indicates the property is of VT_BLOB TypedPropertyValue property. 

vtValue.cbData: 0x000002C8 indicates the count of bytes of the vecHyperlink field. In this 
example, it is 0x000005E6 + 0x0068 - 0x00000386 = 0x000002C8. 

vtValue. vecHyperlink. cElements: 0x00000024 indicates there are six VtHyperlink structures 
(section 2.3.3.1.18) in this array. The number of elements is 1/6 of the value of cElements 
property as each VtHyperlink element (section 2.3.3.1.18) contains six values. 

vtValue.vecHyperlink.rgHyperlink: This is a vector of VtHyperlink structures (section 
2.3.3.1.21) . 

vtValue. vecHyperlink. rgHyperlink.linkElement-1: See the LinkElement-1 Example (section 
3.2. 3.3.1 1 for the structure of this VtHyperlink (section 2. 3.3.1. 18 T The 6 linkElements here 
share the same structure and are described in the following sections. 

3. 2. 3. 3.1 LinkElement-1 Example 

This is an example of a linkElement which consists of 6 structures: dwHash, dwApp, 
dwOfficeArt, dwlnfo, hlinkl, and hlink2. The values of dwApp, dwOfficeArt, and dwlnfo 

define where the hyperlink is applied. The hyperlink can be applied to a shape, a picture in the 
document, an external link to a picture, or other content in the documents. The values of hlinkl 
and hlink2 define where the hyperlink links. The hyperlink can point to a specific item (for example, 
a bookmark or a heading) within the same document, or an external file, or an external site, or a 
specific item in the external site or file. dwHash is the calculated value of the Hyperlink Hash 
(section 2.4.2) algorithm with the values of hlinkl and hlink2 as inputs. 


LinkElement example 1 

Offset 

Size 

Structure 

Value 

0000038A 

006C 

VtHvDerlink - linkElement- 1 


0000038A 

0008 

TypedPropertyValue - dwHash 


0000038A 

0002 

WORD - wType 

0x0003 

0000038C 

0002 

V WORD - padding 

0x0000 

0000038E 

0004 

B^^D - vlfl^^ 

0x00670069 

00000392 

0008 

TypedPropertyValue - dwApp 


00000392 

0002^ 

WORD - wType 

0x0003 

00000394 

/^02 

WORD - padding 

0x0000 

00000396 

0004 

DWORD - value 

0x00000000 

000003QA 

0008 . 

TypedPropertyValue - dwOfficeArt 


0000039A 

0002 

WORD - wType 

0x0003 

0000039C 

0002 

WORD - padding 

0x0000 

0000039E 

0004 

DWORD - value 

0x00000000 

MD00003A2 

0008 

TypedPropertyValue - dwlnfo 
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LinkElement example 1 

000003A2 

0002 

WORD - wType 

0x0003 

000003A4 

0002 

WORD - padding 

0x0000 

000003A6 

0004 

DWORD - value 

0x00000005 

000003AA 

oooc 

TypedPropertyValue - hlinkl 


000003AA 

0002 

WORD - wType 

OxOOlF 

000003AC 

0002 

WORD - padding 

0x0000 

000003AE 

0008 

Lpwstr - vtValue 


000003AE 

0004 

DWORD - cch 

0x00000001 1 

000003B2 

0002 

Array of WCHAR - value 


000003B4 

0002 

Array of bytes - padding 


000003B4 

0001 

BYTE - paddingByte-1 

0x79 i 

000003B5 

0001 

BYTE - paddingByte-2 

[i§g 32 \ 

000003B6 

0040 

TypedPropertyValue - hlink2 


000003B6 

0002 

WORD - wType 

0x001^ 

000003B8 

0002 

WORD - padding 

MDxOOOO 

000003BA 

003C 

Lpwstr - vtValue 


000003BA 

0004 

DWORD - cch 

0X0000001B 

000003BE 

0036 

Array of WCHAR - value 

SkipLevelVerificationStart 

000003F4 

0002 

Array bf bytes -'ppifling 


000003F4 

0001 

BYTE - paddingByte-1 

0x00 

000003F5 

000^ 

^U3YTE - paddingByte-2 

0x00 


linkElement-1: This is a hyperlink that is applied to text content in the document and that links 
to a bookmark in the same document. 


dwHash: The value field of this structure is described in Hyperlink Hash (section 2 . 4 . 2 ). 

dwApp: In this example, the hyperlink is not applied on a shape or a picture or an external link 
to a picture in this document. Therefore, the value of the dwApp structure is an index into a 
PIcFId ( rMS-DOCl section 2.8.35) that corresponds to the beginning character of the 
hyperlink field in the document content. The algorithm to determine the value of dwApp for 
this example is described in 1S-DOC1 section 2.4.7. 

OfficeArt: This hyperlink is not applied to a shape, so the value field of this structure is 
0x00000000. 

dwlnfo: The value field of this structure is 0x00000005 as the hyperlink is not applied to a 
shape and is in a document file as specified by [MS-DOC]. 
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hlinkl: This is the hyperlink target. The value field of this structure is an empty string as this 
hyperlink target is the document itself. 

hlink2: This is the hyperlink location. In this example, the value field of the structure, 
"SkipLevelVerificationStart", is the bookmark in the document that this hyperlink links to. 

hlink2.wType: OxOOlF indicates that vtValue is an Lpwstr (section 2.3.3.1.6) . 

hlink2.vtValue.cch: OxOOOOOOlB indicates the count of characters of the value field of the 
property. OxOOOOOOlB (27) is the count of characters of "SkipLevelVerificationStart" (26) plus 
the terminating NULL character (1). 

hlink2.vtValue. value: The value of this field is the Unicode string "SkipLevelVerificationStart" 
followed by a terminating NULL character. 

hlink2.vtValue. padding: This field adds 2 bytes of padding so that the total length of the 
Lpwstr structure (section 2.3.3.1.6) is a multiple of 4 bytes. 


3. 2. 3. 3. 2 LinkElement-2 Example 

This is an example of a linkElement that illustrates a hyperlink to a document other than the 
document that contains the link. 


LinkElement example 2 


Offset 

Size 

Structure 

Value 

000003F6 

0074 

VtHvDerlink - linkElement-2 


000003F6 

0008 

TypedPropertyValue - dwHash 


000003F6 

0002 

WORD - wType 

|.0x0003 

000003F8 

0002 

WORD - padding 

0x0000 

000003FA 

0004 

DWORD - value 

0x003C0014 

000003FE 

0008 

TypedPropertyValue - dwApp 


000003FE 

0002 

WORD - wType 

0x0003 

00000400 

0002 ^ 

^ WORD - padding 

0x0000 

00000402 

0004 

^^WORD^^ie 

0x00000009 

00000406 

0008 

TypedPropertyValue - dwOfficeArt 


00000406 

0002 

WORD - wType 

0x0003 

00000408 

0002 

WORD - padding 

0x0000 

0000040A 

00^ 

DWORD - value 

0x00000000 

0000040E 

0008 

TypedPropertyValue - dwlnfo 


0000040E 

|p002 

WORD - wType 

0x0003 

00000410 

0002 

WORD - padding 

0x0000 
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LinkElement example 2 

00000412 

0004 

DWORD - value 

0x00000005 

00000416 

0048 

TypedPropertyValue - hlinkl 


00000416 

0002 

WORD - wType 

OxOOlF 

00000418 

0002 

WORD - padding 

0x0000 

0000041A 

0044 

Lpwstr - vtValue 


0000041A 

0004 

DWORD - cch 

0X0000001F 

0000041E 

003E 

Array of WCHAR - value 

C:\MicrosoftOfficeOrgChart.vsd 

0000045C 

0002 

Array of bytes - padding 


0000045C 

0001 

BYTE - paddingByte 

0x00 

0000045D 

0001 

BYTE - paddingByte 

0x00 

0000045E 

oooc 

TypedPropertyValue - hlink2 


0000045E 

0002 

WORD - wType 

0x00 IF 

00000460 

0002 

WORD - padding 

0x0o!)0 

00000462 

0008 

Lpwstr - vtValue 


00000462 

0004 

DWORD - cch 

0x00000001 

00000466 

0002 

Array of WCHAR - value 


00000468 

0002 

Array of bytes - padding 


00000468 

0001 

BYTE - paddingByte 

0x79 

00000469 

0001 

ByTE|^ paddingByte 

0x32 


linkElement-2: This is a hyperlink applied to text content in the document and links to an 
external file. 


dwHash: The value field of this structure Is calculated as specified in the Hyperlink Hash 
(section 2 . 4 . 2 ) . 

dwApp: In this example, the hyperlink is not applied on a shape or a picture or an external link 
to a picture in this document. Therefore, the value of the dwApp structure is an index into a 
PIcFId ( rMS-DQCI section 2.8.35) that corresponds to the beginning character of the 
hyperlink field in the document content. The algorithm to determine the value of dwApp for 
this example is described in rMS-DQCI section 2.4.7. 

dwOfficeArt: This hyperlink is not applied to a shape, so the value field of this structure is 
0x00000000. 

Info: The value field of this structure is 0x00000005 as the hyperlink is not applied to a 
shape and it is in a document specified by [MS-DOC]. 

hlinkl: This is the hyperlink target. The value field of this structure is 

"C:\MicrosoftOfficeOrgChart.vsd" indicating the name of the file that the hyperlink links to. 
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hlink2: This is the hyperlink location. The value field of the structure is an empty string because 
the hyperlink is not referring to a specific item within that file. 


3. 2. 3. 3. 3 LinkElement-3 Example 

This is an example of a linkElement that illustrates a hyperlink to a web resource outside of the 
document that contains the link. 


LinkElement example 3 

Offset 

Size 

Structure 

Value 

0000046A 

006C 

VtHvDerlink - linkElement-3 


0000046A 

0008 

TypedPropertyValue - dwHash 


0000046A 

0002 

WORD - wType 

0x0003 

0000046C 

0002 

WORD - padding 

0x0000 " 

0000046E 

0004 

DWORD - value 

OxOO3i!0064 

00000472 

0008 

TypedPropertyValue - dwApp 


00000472 

0002 

WORD - wType 

0x0003 

00000474 

0002 

WORD - padding 

0x0000 

00000476 

0004 

DWORD - value 

|^x00000006 

0000047A 

0008 

TypedPropertyValue - dwOfficeArt 


0000047A 

0002 

WORD - wType 

0x0003 

0000047C 

0002 

WORD - padding 

0x0000 

0000047E 

0004 

DWORD - value 

0x00000000 

00000482 

0008 

TypedPropertyValue - dwlnfo 


00000482 

0002 , 

WORD - wType 

0x0003 

00000484 

0002 

WORD - padding 

0x0000 

00000486 

0004 

\^/VORD - value 

0x00000005 

0000048A 

0040 

TypedPropertyValue - hlinkl 


0000048A 

0002 

WORD - wType 

OxOOlF 

0000048b 


WORD - padding 

0x0000 

0000048E 

oojM 

Lpwstr - vtValue 


0000048E 

0004 

DWORD - cch 

0X0000001C 

00000492 

k)038 

Array of WCHAR - value 

http://www.wingtiptoys.com/ 

p00004CA 

oooc 

TypedPropertyValue - hlink2 
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to a picture in this document. Therefore, the value of the dwApp structure is an index into a 
PIcFId ( rMS-DOCl section 2.8.35) that corresponds to the beginning character of the 
hyperlink field in the document content. The algorithm to determine the value of dwApp for 
this example is described in T 1S-DOC1 section 2.4.7. 

dwOfficeArt: This hyperlink is not applied to a, shape, so the value field of this structure is 
0x00000000. 

dwlnfo: The value field of this struct ure i| 0x00000005 as the hyperlink is not applied to a 
shape and it is in a document specified by [MS-DOC]. 

hlinkl: This is the hyperlink target. The value field of this structure is 

"http://www.wingtiptoys.com/" specifying the site that the hyperlink links to. 

hlink2: This is the hyperlink location. The value field of the structure is an empty string because 
the hyperlink is not referring to a specific item within that hyperlink target. 


3. 2. 3. 3. 4 LinkElement-4 Example 

This is an example of a linkElement that illustrates a hyperlink to a header inside of the document 
that contains the link. 


LinkElement example 4 

Offset 

Size 

Structure 

Value 

000004D6 

005C 

VtHvDerlink - linkElement-4 


000004D6 

0008 

TypedPropertyValue - dwHash 


000004D6 

0002 

WORD - wType 

0x0003 

000004D8 

0002 

WORD - padding 

0x0000 
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LinkElement example 4 

000004DA 

0004 

DWORD - value 

0x0041004A 

000004DE 

0008 

TypedPropertyValue - dwApp 


000004DE 

0002 

WORD - wType 

0x0003 

000004E0 

0002 

WORD - padding 

0x0000 

000004E2 

0004 

DWORD - value 

0x00000003 

000004E6 

0008 

TypedPropertyValue - dwOfficeArt 


000004E6 

0002 

WORD - wType 

0x0003 

000004E8 

0002 

WORD - padding 

0x0000 \ 

000004EA 

0004 

DWORD - value 

0x00900000 

000004EE 

0008 

TypedPropertyValue - dwlnfo 


000004EE 

0002 

WORD - wType 

0x0003 

000004F0 

0002 

WORD - padding 

0x0000 

000004F2 

0004 

DWORD - value 

|fix000<M)05 

000004F6 

oooc 

TypedPropertyValue - hlinkl 


000004F6 

0002 

WORD - wType 

0x00 IF 

000004F8 

0002 

WORD - padding,-,-* 

0x0000 

000004FA 

0008 

Lpwstr - vtValue 


000004FA 

0004 

DWORD - cch 

0x00000001 

000004FE 

0002 

Array of WCHAR - value 


00000500 

0002 

Array of bytes - padding 


00000500 

oodfl 

^ BYTiP- paddingByte 

0x79 

00000501 

0001 

BYTE - paddingByte 

0x32 

00000502 

opa^ 

TypedPropertyValue - hlink2 


00000502 

0002 

WORD - wType 

OxOOlF 

00000504 1 


WORD - padding 

0x0000 

00000506 

002C- 

Lpwstr - vtValue 


^DOOOlpS^ 

0004 

DWORD - cch 

0x00000014 

0000050A 

0028 

Array of WCHAR - value 

_Verification_Steps 


linkElement-4: This is a hyperlink applied to text content in the document and linked to a 
heading section in the same document. 
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dwHash: The value field of this structure is calculated as specified in the Hyperlink Hash 
(section 2 . 4 . 2 ) . 

dwApp: In this example, the hyperlink is not applied on a shape or a picture or an external link 
to a picture in this document. Therefore, the value of the dwApp structure is an index into a 
PIcFId ( rMS-DOCl section 2.8.35) that corresponds to the beginning character of the 
hyperlink field in the document content. The algorithm to determine the value of dwApp for 
this example is described in rMS-DOCl section 2.4.7. 

dwOfficeArt: This hyperlink is not applied to a shape, so the value field of this structure is 
0x00000000. 

dwlnfo: The value field of this structure is 0x00000005 as the hyperlink is not applies 
shape and it is in a document specified by [MS-DOC]. 

hlinkl: This is the hyperlink target. The value field of this structure is an empty 
hyperlink target is the document itself. 


hlink2: This is the hyperlink location. The value field of the structure 
the heading in this document that this hyperlink links to. 

3. 2. 3. 3. 5 LinkElement-5 Example 

This is an example of a linkElement that illustrates a hyperlii rce outside of the 

document that contains the link, along with an anchor value w ;ource. 



Offset 

Size 

Structure 

Valu^^ 

00000532 

00B4 

VtHvDerlink - linkElement-5 


00000532 

0008 

TypedPropertyValue - 

dwHash 


00000532 

0002 

WORD - wType 

^0x0003 

00000534 

0002 

WORD - padding 

SJbooo 

00000536 

0004 

DWORD - value 

0X0025003E 

0000053A 

0008 

TypedPropertyValue - 

dwApp 


0000053A 

ootul 

WORD - wType 

0x0003 

0000053C 

00(32 

WORD - padding 

0x0000 

0000053E 


DWORD - value 

0x00000000 

00000542 

0008 

TypedPropertyValue - 

dwOfficeArt 


00000542 

Sk 0002 

WORD - wType 

0x0003 

00000544 

0002 

WORD - padding 

0x0000 

F00000546 

0004 

DWORD - value 

0x00000000 
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LinkElement example 5 

0000054A 

0008 

TypedPropertyValue - 

dwlnfo 


0000054A 

0002 

WORD - wType 

0x0003 

0000054C 

0002 

WORD - padding 

0x0000 

0000054E 

0004 

DWORD - value 

0x00000005 

00000552 

006C 

TypedPropertyValue - 

hlinkl 


00000552 

0002 

WORD - wType 

OxOOlF 

00000554 

0002 

WORD - padding 

0x0000 

00000556 

0068 

Lpwstr - vtValue 


00000556 

0004 

DWORD - cch 

0x00000031 

0000055A 

0062 

Array of WCHAR - 

value 

http://en.adatum.com/accounting/managerlist.html 

000005BC 

0002 

Array of bytes - 

padding 


000005BC 

0001 

BYTE - 

paddingByte 

*^8x00 

000005BD 

0001 

BYTE - 

paddingByte 

0x00 

000005BE 

0028 

TypedPropertyValue - 

hlink2 


000005BE 

0002 

WORD - wType 

OxOOlF 

000005C0 

0002 

WORD - padding 

0x0000 

000005C2 

0024 

Lpwstr - vtValue 


000005C2 

0004 

DWORD - cch 

0X0000000F 

000005C6 

001E 

Array of WCHAR - 

value 

emailAddresses 

000005E4 

0CI02 

y Array^ bytes - 

padding 


ooooogi^ 

OQOl 

BYTE - 

paddingByte 

0x00 

000005E5 

0001 

BYTE - 

paddingByte 

0x00 


linkElement-5: This is a hyperlink applied to text content in the document and linked to a 
bookmark on an external site. 
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dwHash: The value field of this structure is calculated as specified in the Hyperlink Hash 
(section 2 . 4 . 2 ) . 

dwApp: In this example, the hyperlink is not applied on a shape or a picture or an external link 
to a picture in this document. Therefore, the value of the dwApp structure is an index into a 
PIcFId ( rMS-DOCl section 2.8.35) that corresponds to the beginning character of the 
hyperlink field in the document content. The algorithm to determine the value of dwApp for 
this example is described in rMS-DOCl section 2.4.7. 

dwOfficeArt: This hyperlink is not applied to a shape, so the value field of this structure is 
0x00000000. 

dwlnfo: The value field of this structure is 0x00000005 as the hyperlink is not applied t 
shape and it is in a document specified by [MS-DOC]. 

hlinkl: This is the hyperlink target. The value field of this structure is 

"http://en.adatum.com/accounting/managerlist.html" indicating the site that the hyperlink 
links to. 

hlink2: This is the hyperlink location. The value field of the structure, "emailAddresses", is the 
anchor in the target site that this hyperlink links to. 


3. 2. 3. 3. 6 LinkElement-6 Example 

This is an example of a linkElement that illustrates a hyperlink located on a shape embedded in the 
document to a header within the document that contains the link. 


LinkElement example 6 


Offset 

Size 

Structure 

Value 

000005E6 

0068 

VtHvDerlink - linkElement-6 


000005E6 

0008 

TypedPropertyValue - dwHash 


000005E6 

0002 

WORQ^- wType 

0x0003 

000005E8 

0002 

WORD - padding 

0x0000 

000005EA 

0004 

DWORD - value 

0x006B0028 

000005EE 

0008 

TypedPropertyValue - dwApp 


000005EE 

0002 

WORD - wType 

0x0003 

000005F0 

iGT 

WORD - padding 

0x0000 

000005F2 

fcooj 

▲pWORD - value 

OxFFFFFFFF 

000005F6 

0008 

TypedPropertyValue - dwOfficeArt 


000005F6 

0002 

WORD - wType 

0x0003 

000005F8 

0002 

WORD - padding 

0x0000 

000005FA 

0004 

DWORD - value 

0x00000402 

^000005FE 

0008 

TypedPropertyValue - dwlnfo 
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LinkElement example 6 

000005FE 

0002 

WORD - wType 

0x0003 

00000600 

0002 

WORD - padding 

0x0000 

00000602 

0004 

DWORD - value 

0x00000004 

00000606 

oooc 

TypedPropertyValue - hlinkl 


00000606 

0002 

WORD - wType 

OxOOlF 

00000608 

0002 

WORD - padding 

0x0000 

0000060A 

0008 

Lpwstr - vtValue 


0000060A 

0004 

DWORD - cch 

0x00000001 ^ 

0000060E 

0002 

Array of WCHAR - value 


00000610 

0002 

Array of bytes - padding 


00000610 

0001 

BYTE - paddingByte 

Ox? 9 A 

00000611 

0001 

BYTE - paddingByte 

0x32 M 

00000612 

003C 

TypedPropertyValue - hlink2 


00000612 

0002 

WORD - wType 

OxoSjp^ 

00000614 

0002 

WORD - padding 

^ 0x0000 

00000616 

0038 

Lpwstr - vtValue 


00000616 

0004 

DWORD - cch 

0x00000019 

0000061A 

0032 

Array of WCHAR - value 

_Skip-level_Verification 

0000064C 

0002 

Array of bytes - padding 


0000064C 

0001 

BYTE - paddingByte 

0x00 

0000064D 

OOO^k 

BYTE - paddingByte 

0x00 


linkElement-6: This is a hyperlink applied to a shape in the document and linked to a heading 
section within the same document. 

dwHash: The value field of this structure is calculated as specified in the Hyperlink Hash 
(section 2.4. 2) . 

lue field of this structure is OxFFFFFFFF as the hyperlink is applied to a shape. 

: iceArt: The value field of this structure is 0x00000402. It indicates the identifier of the 
shape to which the hyperlink is applied. 

wlnfo: The value field of this structure is 0x00000004 because the hyperlink is applied to a 
shape as defined in rMS-ODRAWl section 2.5.1. 

hlinkl: This is the hyperlink target. The value field of this structure is an empty string when the 
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hlink2: This is the hyperlink location. The value field of the structure, "_Skip-level_Verification", 
is the heading in this document that this hyperlink links to. 

3. 2. 3. 4 Linked Property Example 


The following table illustrates the value property of a link/value property pair that defines a Linked 
Property (section 2.3.3.2.3.3V 


Structure of the CriticalSection property 

Offset 

Size 

Structure 

Value 

00000672 

0020 

Typed Property Value - CriticalSection 


00000672 

0002 

WORD - wType 

OxOOlE 

00000674 

0002 

WORD - padding 

0x0000 

00000676 

001C 

Lpstr - stringValue 


00000676 

0004 

DWORD - cch 

c^oo^H | 

0000067A 

0018 

Array of CHAR - value 

Sign the approval form 


The CriticalSection property is an Lpstr property (section 2.3.3.1.4 V see Category Property 
Example (section 3.2.2.2V The value field of CriticalSection has been populated with the string 
contained by the bookmark specified in CriticalSection_Link. 


The following table illustrates the link property of a link/value property pair that defines a Linked 
Property (section 2.3.3.2.3.3V 


Structure of the CriticalSection_Link property 

Offset 

Size 

Structure 

Value 

00000692 

0024 

VtStrinq - CriticalSection_Link 


00000692 

0002 

^^WORD - stringType 

OxOOlE 

00000694 

0002 

WORD - padding 

0x0000 

00000696 

0020 ^ 

Lpstr - stringValue 


00000696 

000^^ 

DWORD - cch 

0X0000001C 

0000069A 

prrj 

of CHAR - value 

SkipLevelVerificationStart 


The CriticalSection_Link property is an Lpstr property (section 2.3.3.1.4V see Category Property 
Example (section VI ). The value field of CriticalSection_Link is a bookmark in the document 
content of the containing document file. The value contained in this bookmark is stored in the 

CriticalSection property. 

The previous two tables have propld values of 0x00000007 and 0x01000007 in rgUserProps, see 
UserDefined Property Set Overview (section 3.2.3V Taken together they are an example of a Linked 
Property (section 2.3.3.2.3.3V The table with propID 0x01000007 (CriticalSection_Link) stores 
the name of the bookmark. The table with propID 0x00000007 (CriticalSection) stores the value 


178/205 

[MS-OSHARED] - V20120122 
Office Common Data Types and Objects Structures 

Copyright © 2012 Microsoft Corporation. 

Release: Sunday, January 22, 2012 


of the bookmark. When the example file was saved, the value of the bookmark, the name of which 
was saved in the CriticalSection_Link property, was saved in the CriticalSection property. 


3.3 SmartTag Examples 

This section contains an example about how smart tag information is embedded in the document. 
In the following example, two smart tags of the following types are embedded in the document: 

■ Stockticker 

■ Date 

The following is the example for the shared data stored in the PropertvBaqStore structure (section 
2.3.4.1T 



For simplicity this structure is broken down into substructures that are explained after the following 
descriptions. 

propBagStore: Structure of type PropertyBagStore (section 2.3.4.1T 

cFactoidType: 0x00000002 specifies the number of distinct smart tag types embedded in the 
document. 

factoid : ^r^y of ty$§/FactoidType structures (section 2.3.4.21 as specified by the 
toidType field. 

OxOOOC specifies the count of total bytes, including itself and the sVer, cfactoid, and 
ields. 



sr: 0x0100 specifies the version of this structure, 
cfactoid: 0x089A7948 is an arbitrary and ignored value, 
cste: 0x00000008 specifies the total number of entries in the stringTable. 
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The substructures identified by label A, B, and C in the preceding example are shown in the 
table labeled "FactoidType structure for Stockticker smart tag type", the table labeled 
"FactoidType structure for Date smart tag type", and the table labeled "IndexedStringTable 
structure", respectively. 


FactoidType structure for Stockticker smart tag type 

Offset 

Size 

Structure 

Value 

0000142E 

0043 

A: FactoidType - factoidType- 
O 


0000142E 

0004 

ULONG - cbFactoid 

0X0000003F 

00001432 

0004 

ULONG - id 

0x00000001 

00001436 

002C 

PBStrinq - rgbUri 


00001436 

15 

bits 

USHORT - cch 

0x002A 

00001436 

1 bit 

USHORT - fAnsiString 

0x1 

00001438 

002A 

array of bytes - rgxch 

urn:schemas-microsoft- 
com: office :smarttags 

00001462 

000D 

PBString - rgbTag 


00001462 

15 

bits 

USHORT - cch 

0x0006 

00001462 

1 bit 

USHORT - fAnsiString 

0x1 

00001464 

000B 

array of bytes - rgxch 

stockticker 

0000146F 

0002 

PBString - 

rgbDownLoadURL 


0000146F 

15 4 

bits " 

USHORT - cch 

0x0000 

0000146F 


^^SHOR^hmsiString 

0x1 

00001471 

0000 

array of bytes - rgxch 




This is the first FactoidType structure (section 2.3.4.2) corresponding to the Stockticker smart 
tag type. For simplicity, detailed descriptions for the subfields cch and fAnsiString of 
rgbTag and rgbDownloadURL have been omitted. 

cbFactoid: Ox0000003F specifies the size of this structure excluding the cbFactoid field. 

id: 0x00000001 specifies the unique id (across this document) for this smart tag type. 

bUri.cch: 0x002A specifies the number of characters in the string pointed to by rbgUri.rgxch. 

bUri. fAnsiString: 0x1 specifies that the string pointed to by rgbUri.rgxch is an ANSI 
character set string. 

rgbUri.rgxch: "urn:schemas-microsoft-com:office:smarttags" specifies the XML namespace URI 
for this smart tag type. 
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rgbTag.rgxch: "stockticker" specifies the tag name for this smart tag type. 


rgbDownLoadURL.rgxch: This field is empty because there is no download URL specified for 
this particular smart tag type. 


FactoidType structure for Date smart tag type 

Offset 

Size 

Structure 

Value 

00001471 

003C 

B: FactoidType - factoidType- 
1 


00001471 

0004 

ULONG - cbFactoid 

0x00000038 

00001475 

0004 

ULONG - id 

0x00000002 

00001479 

002C 

PBString - rgbllri 


00001479 

15 

bits 

USHORT - cch 

0x002A 

00001479 

1 bit 

USHORT - fAnsiString 

0x1 

0000147B 

002A 

array of bytes - rgxch 

urn:schgrnas-microSt- , 

com:office:smarttags 

000014A5 

0006 

PBString - rgbTag 


000014A5 

15 

bits 

USHORT - cch 

0x0004 

000014A5 

1 bit 

USHORT - fAnsiString 

0x1 

000014A7 

0004 

array of bytes - rgxch 

d ^w 

000014AB 

0002 

PBString - 

rgbDown Load URL 


000014AB 

bits % 

U#i<3j(tT - cch 

0x0000 

000014AB 


^^ISHO^&AnsiString 

0x1 

000014AD 

0000 

array of bytes - rgxch 



-ucture (section 2 . 3 . 4 . 2 ) corresponding to the Date smart 
j descriptions for all the fields except id have been omitted. 


ifies the unique id (across this document) for the Date smart tag. 






joffset 

Size 

Structure 

Value 

000014B9 

002B 

C: IndexedStringTable - stringTable 


0000148^ 

0004 

PBString - stringTableEntry-0 


000014B9 

15 bits 

USHORT - cch 

0x0002 
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IndexedStringTable structure 

000014B9 

1 bit 

USHORT - fAnsiString 

0x1 

000014BB 

0002 

array of bytes - rgxch 

10 

000014BD 

0006 

PBString - stringTableEntry-1 


000014BD 

15 bits 

USHORT - cch 

0x0004 

000014BD 

1 bit 

USHORT - fAnsiString 

0x1 

000014BF 

0004 

array of bytes - rgxch 

2003^^ 

000014C3 

0004 

PBString - stringTableEntry-2 


000014C3 

15 bits 

USHORT - cch 

0x0002 

000014C3 

1 bit 

USHORT - fAnsiString 

oil 

000014C5 

0002 

array of bytes - rgxch 

k21 

000014C7 

0005 

PBString - stringTableEntry-3 


000014C7 

15 bits 

USHORT - cch 

$)x0003 

000014C7 

1 bit 

USHORT - fAnsiString 

0x1 

000014C9 

0003 

array of bytes - rgxch 

Day 

000014CC 

0004 

PBString - stringTableEntry-4 


000014CC 

15 bits 

USHORT - cch 

0x0002 

000014CC 

1 bit 

USHORT - fAnsiString 

0x1 

000014CE 

0002 

array of bytes - rgxch 

Is 

000014D0 

0007 

PBString - stringTableEntry-5 


000014D0 

l®ts 

USHORT - cch 

0x0005 

000014D0 

1 bit 

USHORT - fAnsiString 

0x1 

000014D2 

0005 

array of bytes - rgxch 

Month 

000014D7 

0007 

PBString - stringTableEntry-6 


000014D7 

15 bits 

USHORT - cch 

0x0005 

00D014D7 

1 bit 

USHORT - fAnsiString 

0x1 

000014D9 

0005 

array of bytes - rgxch 

trans 

000014DE 

0006 

PBString - stringTableEntry-7 


000014DE 

15 bits 

USHORT - cch 

0x0004 

000014DE 

1 bit 

USHORT - fAnsiString 

0x1 

000014E0 

0004 

array of bytes - rgxch 

Year 
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This is an array of string table entries. For simplicity, only the detailed description for entries 
at indexes 1 and 7 are shown. These two entries are referred to by the Date smart tag's 
PropertvBaq structure (section 2.3A.3) to form a key/value pair. The descriptions for the cch 
and fAnsiString subfields are also omitted. 

stringTableEntry-1: String table entry at index 1. 

stringTableEntry-l.rgxch: "2003" specifies this particular string entry. 

stringTableEntry-7: String table entry at index 7. 

stringTableEntry-7.rgxch: "Year" specifies this particular string entry. 

The following example shows how data private to the individual smart tag is persi 
example, the smart tags for the following data items were embedded in the document 

■ 10/21/2003 

■ MSFT 

The first data item was recognized as a date by the Date smart tac| 
was recognized as a stock symbol by the Stockticker smart tag. 




PropertyBag structures 

Offset 

Size 

Structure 

▲ 

Value 

000014E4 

002C 

PropertyBags - propBags 


000014E4 

0026 

PropertyBag - propertyBag-0 


000014E4 

0002 

USHORT - id | 

0x0002 

000014E6 

0002 

USHORT - cProp 

0x0004 

000014E8 

0002 

USHORT - cbllnknown 

0x0000 

000014EA 

0020 

Properties - properties 


000014EA 

0008 A 

E - property-0 


000014EA 

0004 

1 ULONG - keylndex 

0x00000004 

000014EE 

0004 

ULONG - valuelndex 

0x00000006 

000014F2 

ini’ 08 i 

j Property - property-1 


000014F2 

0004 

ULONG - keylndex 

0x00000005 

000014F6 

0004 y 

ULONG - valuelndex 

0x00000000 

000014FA 

0008 

Property - property-2 


0000 14FA 

0004 

ULONG - keylndex 

0x00000003 

00d§i*FE 

0004 

ULONG - valuelndex 

0x00000002 

000015^2 

0008 

Property - property-3 


00001502 

0004 

ULONG - keylndex 

0x00000007 
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PropertyBag structures 

00001506 

0004 

ULONG - valuelndex 

0x00000001 

0000150A 

0006 

PropertyBag - propertyBag-1 


0000150A 

0002 

USHORT - id 

0x0001 

0000150C 

0002 

USHORT - cProp 

0x0000 

0000150E 

0002 

USHORT - cbUnknown 

0x0000 

00001510 

0000 

Properties - properties 

— 


For simplicity detailed descriptions for propertyBag-l.cProp and propertyBag- 
l.cbUnknown have been omitted. 

propBags: An array of PropertyBag (section 2.3A.3) . 

propertyBag-O: The first PropertyBag (section 2.3.4. 3 ). 

propertyBag-O.id: 0x0002 specifies the FactoidType (section 2.3.4.2r id. Ais value maps it to 
the Date smart tag type as shown in the factoidTypes.factoidType-1 field of PropertyBag 
(section 2. 3. 4.3 ). 


propertyBag-O.cProp: 0x0004 specifies the number of 
tag. 

propertyBag-O.cbUnknown: 0x0000 specifies th; 



:rties stored as part of this smart 


'n field does not exist. 


propertyBag-O. properties: An array of ke y/ valu e pair indexes in the StringTable field as 
shown in the preceding example. For simplicity, only the entry at index 3 is shown. 

propertyBag-O.properties.property-3: Key/value pair at index 3. The pair as shown evaluates 
to "Year"="2003". 

propertyBag-O. properties. property-3. keylndex: 0x00000007 specifies index in the 
StringTable field of PropertyBag (section 2.3.4.. ). This maps to the string "Year". 

propertyBag-O.pi 
StringTable fie 


propertyBag-1: 

propertyBag 

the Stod 
Propertyl 



irties. property-3. valuelndex: 0x00000001 specifies the index in the 
PropertyBag (sed»p. 2.3.4.3T This maps to the string "2003". 

gag (section 2.3.4. 3 T 

£ifies the FactoidType (section 2.3.4.2) id. This value maps it to 
as shown in the factoidTypes.factoidType-0 field of the 


propertyBag-1. properties: This smart tag does not have any properties. 

3.4 Visual Basic for Applications Digital Signature Example Structures 

This is an example of a Visual Basic for Applications (VBA) digital signature storage structure. In this 
example, the structure of the digital signature is for a document as specified by fMS-XLSl . The 
digital signature of a document specified by rMS-PPTl has the same structure as described in this 
example. The digital signature of a document specified by rMS-DOCl is slightly different than this 
example. The difference is described in Visual Basic for Applications Digital Signature (section 

L2A)- 
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VBA digital signature 

Offset 

Size 

Structure 

Value 

00000120 

0754 

DiaSiaBlob - vbaDiaSia 


00000120 

0004 

ULONG - cb 

0X0000074C 

00000124 

0004 

ULONG - serializedPointer 

0x00000008 

00000128 

074C 

DiaSiqlnfoSerialized - sianaturelnfo 


00000128 

0004 

DWORD - cbSignature 

0X000003E4 

0000012C 

0004 

DWORD - signatu reOffset 

0X0000002C 

00000130 

0004 

DWORD - cbSigningCertStore 

0x00000340 

00000134 

0004 

DWORD - certStoreOffset 

0x000004^.^ 

00000138 

0004 

DWORD - cbProjectName 

oxoo^T ' 

0000013C 

0004 

DWORD - projectNameOffset 

0x00^07^^ 

00000140 

0004 

BOOL - (Timestamp 

0x00000000 

00000144 

0004 

DWORD - cbTimestampUrl 

0x00000000 

00000148 

0004 

DWORD - timestampUrlOffset 

0x00000752 

0000014C 

03E4 

SignedData - pbSignatureBuffer 

30 82 03 E0 06 09 ... 

00000530 

0340 

VBASiaSerializedCertStore - 

pbSigningCertStoreBuffer 


00000530 

0004 

DWORD - version 

0x00000000 

00000534 

0004 

DWORD - fileType 

0x54524543 

00000538 

032C 

CertStoreCertificateGrouD - certGrouD 


00000538 

0108 

Array of SerializedPropertyEntry - 

elementList 


00000538 

0020 

SerializedProDertvEntrv - 

certStorePropElement-1 


00000538 

0004 

DWORD - id 

0x00000014 

0000053C 

0004 

DWORD - encodingType 

0x00000001 

00000540 

0004 

DWORD - length 

0x00000014 

00000544 

0014 

Array of bytes - value 

3C 6B 4E A5 18 10 4F 7F 8F 6F 

03 AD 5D FB D1 B5 71 IE 93 21 

00000558 

kO0A8 

SerializedPropertyEntry - 

certStorePropElement-2 


^0000600 

0020 

SerializedPropertyEntry - 

certStorePropElement-3 
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VBA digital signature 

00000620 

0020 

SerializedPropertyEntry - 

certStorePropElement-4 


00000640 

0224 

SerializedCertificateEntrv - 

certificateElement 


00000640 

0004 

DWORD - id 

0x00000020 

00000644 

0004 

DWORD - encodingType 

0x00000001 

00000648 

0004 

DWORD - length 

0x00000218 

0000064C 

0218 

Array of bytes - certificate 

30 82 02 14 30 82 ..^r 

00000864 

oooc 

EndElementMarkerEntrv - 

endMarkerElement 


00000864 

0004 

DWORD - id 

0x00000000 

00000868 

0008 

Array of bytes - marker 

00 00 00 00 00 00 00 00 

00000870 

0002 

Array of WCHAR - 

rgchProjectNameBuffer 


00000872 

0002 

Array of WCHAR - rgchTimestampBuffer 


00000874 

0000 

Array of bytes - padding 



In this example, certStorePropElement-2 through certStorePropElement-4 have the same 
structure as certStorePropElement-1. See the certStorePropElement-1 element for details. 

cb: 0x0000074C is the count of bytes of the signaturelnfo and padding fields combined, 
serialized Pointer: 0x00000008 is the offset for the signaturelnfo structure, 
signaturelnfo: This is the structure that contains detailed data for the VBA digital signature. 

signaturelnfo. cbSignature: 0x000003E4 is the count of bytes for the pbSignatureBuffer 

field. 

signaturelnfo. signatureOffset: 0x0000002C indicates that the pbSignatureBuffer field 
begins 0x0000002C bytes after the beginning of its parent DigSigBlob (section 2.3. 2. 2 ) . In 
this example, the parent DigSigBlob begins at offset 0x00000120. Therefore, the 
pbSignatureBuffer field begins at offset 0x0000014C. 

signaturelnfo. cbSigningCertStore: 0x00000340 is the count of bytes of the 

pbSigningCertStoreBuffer. 

irelnfo.certSto reOffset: 0x00000410 indicates that the pbSignatureCertStoreBuffer 

begins 0x00000410 bytes after the beginning of its parent DigSigBlob (section 2.3.2.2T 
is example, the parent DigSigBlob begins at offset 0x00000120. Therefore, the 
gningCertStoreBuffer field begins at offset 0x00000530. 



gnaturelnfo.cbProjectName: 0x00000000 is the count of bytes not including the terminating 
NULL character of the rgchProjectNameBuffer field. 
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signaturelnfo.projectNameOffset: 0x00000750 indicates that the rgchProjectNameBuffer 

field begins 0x00000750 bytes after the beginning of its parent DigSigBlob (section 2.3.2.2T 
In this example, the parent DigSigBlob begins at offset 0x00000120. Therefore, the 
rgchProjectNameBuffer field begins at offset 0x00000870. 

signaturelnfo.fTimestamp: 0x00000000 is a reserved value. 

signaturelnfo.cbTimestampUrl: 0x00000000 is the count of bytes not including the 
terminating NULL character of the rgchTimestampBuffer field. 

signaturelnfo.timestampUrlOffset: 0x00000752 indicates that the rgchTimestampBuffer 

field begins 0x00000752 bytes after the beginning of its parent DigSigBlob (section 2. 3. 2. 2' 

In this example, the parent DigSigBlob begins at offset 0x00000120. Therefore, the 
rgchTimestampBuffer field begins at offset 0x00000872. 

signaturelnfo.pbSignatureBuffer: The value of this field is a VBA digital signature as 
described in VBA Digital Signature (section 2.3.2.4 1. 

signaturelnfo.pbSigningCertStoreBuffer: The value of this field is a 

VBASigSerializedCertStore structure (section 2.3.2.5.5 I containing the digital certificate used 
to create the digital signature. 

signaturelnfo.pbSigningCertStoreBuffer.version: 0x00000000 indicates the version of the 
structure. 

signaturelnfo.pbSigningCertStoreBuffer.fileType: 0x54524543 indicates that the data 
contained in pbSigningCertStoreBuffer is a digital certificate store type. 

signaturelnfo.pbSigningCertStoreBuffer.certGroup: This is a container of digital certificate 
store elements representing a single digital certificate and a collection of properties associated 
with that certificate. 

signaturelnfo.pbSigningCertStoreBuffer.certGroup.elementList: This is the container of an 
array of SerializedPropertyEntry (section 2.3.2. 5.3 T 

signaturelnfo. pbSigningCertStoreBuffer. certGroup.elementList.certStorePropElement- 

1: This is the first element in this SerializedPropertyEntry (section 2.3.2.5.31 array. 

signaturelnfo. pbSigningCertStoreBuffer.certGroup.elementList.certStorePropElement- 
l.id: 0x00000014 is the identifier of the property. 

signaturelnfo. pbSigningCertStoreBuffer.certGroup.elementList.certStorePropElement- 
l.encodingType: 0x00000001 is a reserved value. 

signaturelnfo. pbSigningCertStoreBuffer.certG roup. elementList.certStorePropElement- 
1. length: 0x00000014 is the count of bytes of the value field in this element. 

signaturelnfo. pbSigningCertStoreBuffer.certGroup.elementList.certStorePropElement- 
alue: The value of this field is ignored on read. 


siynaiurelnfo.pbSigningCertStoreBuffer.certGroup.certificateElement: This is a 

SerializedCertificateEntry structure (section 2.3.2.5.1j containing the certificate stored in this 
digital certificate store. 

ignaturelnfo.pbSigningCertStoreBuffer.certGroup.certificateElement.id: 0x00000020 
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signaturelnfo.pbSigningCertStoreBuffer.certGroup.certificateElement.encodingType: 

0x00000001 is a reserved value. 

signaturelnfo.pbSigningCertStoreBuffer.certGroup.certificateElement.length: 

0x00000218 is the count of bytes of the certificate field in this element. 

signaturelnfo.pbSigningCertStoreBuffer.certGroup.certificateElement.certificate: The 

value of this field is the certificate data (IRFC3280I). 

signaturelnfo.pbSigningCertStoreBuffer.endMarkerElement: This is the container of a 
special entry in the VBASigSerializedCertStore structure (section 2.3.2.5.5) that marks the 
end of the VBASigSerializedCertStore structure. 

signaturelnfo.pbSigningCertStoreBuffer.endMarkerElement.id: 0x00000000 is a reserved 
value. 

signaturelnfo.pbSigningCertStoreBuffer.endMarkerElement.marker: 00 00 00 00 00 00 

00 00 is the sentinel value for the end of the store. 

signaturelnfo.rgchProjectNameBuffer: The value of the field is an empty string (a single null 
Unicode character). 

signaturelnfo.rgchTimestampBuffer: The value of the field i^n empty string (a single null 
Unicode character). 

padding: The padding field is an array of bytes. The size of this array is the number of bytes 
necessary to pad the size of the signaturelnfo field to a multiple of 4 bytes. In this example, 
the count of bytes of the signaturelnfo field is Qx0000074C, a multiple of 4 bytes. Therefore, 
no padding is needed. 
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4 Security Considerations 

4.1 Toolbar Customization 


None. 

4.2 Property Set Storage 

None. 

4.3 Visual Basic for Applications Digital Signature 

The Visual Basic for Applications (VBA) digital signature is generated using the MD5 hash 
(IRFC132JJ). This hash algorithm is no longer the preferred algorithm for creating data hashes or 
digitally signed content. Other hash algorithms (for example SHA-1 rFIPS180-21 ) provide stronger 
integrity than MD5. 

It is recommended that implementers of this specification consider using one of these more secure 
hash algorithms to generate the digital signature for the VBA project. 

The VBA project data hash as described in rMS-OVBAl section 2.4.2 continues to require MD5 hash, 
even if the digital signing of that data uses a different algorithm. This requirement exists to support 
cross-version compatibility. This means that even if the digital signature uses an alternate 
alqorithm, the digest field of Diqestlnfo in SpcIndirectData (section 2, 3. 2. 4. 3.1) always contains a 
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5 Appendix A: Product Behavior 

The information in this specification is applicable to the following Microsoft products or supplemental 
software. References to product versions include released service packs: 

■ Microsoft® Office 97 

■ Microsoft® Office 2000 

■ Microsoft® Office XP 

■ Microsoft® Office 2003 

■ the 2007 Microsoft® Office system 

■ Microsoft® Office 2010 suites 

■ Microsoft® Office 15 Technical Preview 

Exceptions, if any, are noted below. If a service pack or Quick Fix Engineering (QFE', 
appears with the product version, behavior changed in that service pack or QFE. The new behavior 
also applies to subsequent service packs of the product unless otherwise specified. If a product 
edition appears with the product version, behavior is different in that product edition. 

Unless otherwise specified, any statement of optional behavior in this specification that is prescribed 
using the terms SHOULD or SHOULD NOT implies product behavior in accordance with the SHOULD 
or SHOULD NOT prescription. Unless otherwise specified, the term MAY implies that the product 
does not follow the prescription. 

<1> Section 1.5: These persistence formats provide interoperability with applications that create or 
read documents conforming to this structure, including Word 97, Word 2000, Word 2002, Office 
Word 2003, Excel 97, Excel 2000, Excel 2002, Office Excel 2003, PowerPoint 97, PowerPoint 2000, 
PowerPoint 2002, and Office PowerPoint 2003. These persistence formats can also be used for 
interoperability with Office Word 2007, Word 2010, Office Excel 2007, Excel 2010, Office PowerPoint 
2007, or PowerPoint 2010 when compatibility with Word 97, Word 2000, Word 2002, Office Word 
2003, Excel 97, Excel 2000, Excel 2002, Office Excel 2003, PowerPoint 97, PowerPoint 2000, 
PowerPoint 2002, and Office PowerPoint 2003 is a primary concern. 

<2> Sect irin * 1 some uncompressed bitmaps, this value is equal to 0x0000 and does not 

specify the size of the image. 

<3> Section 2.3.1.6: In Excel 97, Excel 2000, Excel 2002, Office Excel 2003, Office Excel 2007, and 
Excel 2010, cCL specifies the number of toolbar controls in the toolbar. In Word 97, Word 2000, 
Word 2002, Office Word 2003, Office Word 2007, and Word 2010 cCL does not specify the number 
of toolbar controls in the toolbar and the value of cCL is equal to OxFF (-1). 

<4> Section 2.3. 1.8: In Word 97, Word 2000, Word 2002, Office Word 2003, Office Word 2007, and 
Word 2010, fCtIModified can be 0 and the toolbar can still save its toolbar controls to the file. In 
Excel 97, Excel 2000, Excel 2002, Office Excel 2003, Office Excel 2007, and Excel 2010, 
fCtIModified is always equal to 1 and ignored. 

<5> Section 2. 3. 1.9: When tbds is greater than 0x03, this field specifies the most recent toolbar 
dock state. 

<6> Section 2.3.1.12: In Word 97, Word 2000, Word 2002, Office Word 2003, Office Word 2007, 
and Word 2010, fNoSetCursor is equal to 0 if the tcid value of the TBCHeader structure that 
contains this structure does not equal 0x0001. In Excel 97, Excel 2000, Excel 2002, Office Excel 
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2003, Office Excel 2007, and Excel 2010, fNoSetCursor is equal to the appropriate value listed in 
rMS-CTXLSl section 2.2 if the tcid value of the TBCHeader structure that contains this structure 
does not equal 0x0001. 

<7> Section 2.3.1.12: In Excel 97, Excel 2000, Excel 2002, Office Excel 2003, Office Excel 2007, 
and Excel 2010, fNoAccel is equal to 0 if the tct value of the TBCHeader structure (section 
2.3.1.101 that contains this structure is equal to OxOF. Otherwise, if tct is not equal to OxOF, 
fNoAccel is equal to 1. In Word 97, Word 2000, Word 2002, Office Word 2003, Office Word 2007, 
and Word 2010, fNoAccel is equal to the appropriate value listed in rMS-CTDOCl section 2.2 if the 
tcid value of the TBCHeader structure that contains this structure does not equal 0x0001. 

<8> Section 2.3.1.12: In Word 97, Word 2000, Word 2002, Office Word 2003, Office Word 2007, 
and Word 2010 fAlwaysEnabled is equal to 0 if the tcid value of the TBCHeader structure (section 
2.3.1.101 that contains this structure does not equal 0x0001. In Excel 97, Excel 2000, Excel 2002, 
Office Excel 2003, Office Excel 2007, and Excel 2010, fAlwaysEnabled is equal to the appropriate 
value listed in rMS-CTXLSl section 2.2 if the tcid value of the TBCHeader structure that contains 
this structure does not equal 0x0001. 

<9> Section 2.3.1.12: In Word 97, Word 2000, Word 2002, Office Word 2003, Office Word 2007, 
and Word 2010, fExclusivePopup is equal to 0. In Excel 97, and Excel 2000, fExclusivePopup is 
equal to 1 when the tcid field of the TBCHeader structure (section 2.3.1.10 1 that contains this 
structure equals 0x0001. In Excel 2002, Office Excel 2003, Office Excel 2007, and Excel 2010, 
fExclusivePopup is equal to 1 when the tcid field of the TBCHeader structure that contains this 
structure equals 0x0001 and when the tct field the TBCHeader structure (section 2.3.1.101 that 
contains this structure equals one of the following values: OxOA, OxOB, OxOC, OxOD, or OxOE. In 
Excel 2002, Office Excel 2003, Office Excel 2007, and Excel 2010, fExclusivePopup is equal to 0 
when the tcid field of the TBCHeader structure that contains this structure equals 1 and when the 
tct field the TBCHeader structure that contains this structure does not equal any of the following 
values: OxOA, OxOB, OxOC, OxOD, and OxOE. In Excel 97, Excel 2000, Excel 2002, Office Excel 2003, 
Office Excel 2007, and Excel 2010, fExclusivePopup is equal to the appropriate value listed in rMS- 
CTXLSl section 2.2 if the tcid value of the TBCHeader structure that contains this structure does not 
equal 0x0001. 

<10> Section 2.3.1.12: In Word 97, Word 2000, Word 2002, Office Word 2003, Office Word 2007, 
and Word 2010, fDefaultBehavior t§J|qual to 0. In Excel 97, Excel 2000, Excel 2002, Office Excel 
2003, Office Excel 2007, and Excel 2010, fDefaultBehavior is equal to 0 when the tcid field of the 
TBCHeader structure (section 2.3.1.10 1 that contains this structure equals 0x0001 and is equal to 1 
when the tcid field of the TBCHeader structure that contains this structure does not equal 0x0001. 

<11> Section 2.3.1.14: If the toolbar control is of type Button or ExpandingGrid, and the 
fHyperlinkType field of the TBCBSFIaqs structure (section 2.3.1.18 1 contained by the TBCBSpecific 
structure (section 2.3.1.17 1. contained by the TBCData structure (section 2.3.1.131 that contains 
the TBCGenerallnfo structure (section 2.3.1.141 that contains this structure does not equal 0, the 
value of tooltip specifies the hyperlink path for the toolbar control. 

<12> Section 2.3.1.18: In Word 2000, Word 2002, Office Word 2003, Office Word 2007, Word 
2010, Excel 2000, Excel 2002, Office Excel 2003, Office Excel 2007, and Excel 2010, reservedl is 
equal to F In Word 97, and Excel 97, reservedl is equal to 0 and ignored. 

<13> Section 2. 3. 2. 4.1: Word 97, Word 2000, Word 2002, Office Word 2003, Office Word 2007, 
Word 2010, PowerPoint 97, PowerPoint 2000, PowerPoint 2002, Office PowerPoint 2003, Office 
PowerPoint 2007, PowerPoint 2010, Excel 97, Excel 2000, Excel 2002, Office Excel 2003, Office 
Excel 2007, and Excel 2010 use the MD5 algorithm to create the signature digest, specified by the 
identifier "1.2.840.113549.2.5". 


191/205 

[MS-OSHARED] - V20120122 
Office Common Data Types and Objects Structures 

Copyright © 2012 Microsoft Corporation. 

Release: Sunday, January 22, 2012 


<14> Section 2. 3. 2.4.4. 2: Word 97, Word 2000, Word 2002, Office Word 2003, Office Word 2007, 
Word 2010, PowerPoint 97, PowerPoint 2000, PowerPoint 2002, Office PowerPoint 2003, Office 
PowerPoint 2007, PowerPoint 2010, Excel 97, Excel 2000, Excel 2002, Office Excel 2003, Office 
Excel 2007, and Excel 2010 do not provide a value for the programName string when signing the 
VBA project. However, if one is provided the applications interpret it. 

<15> Section 2.3.2.4.4.2: Word 97, Word 2000, Word 2002, Office Word 2003, Office Word 2007, 
Word 2010, PowerPoint 97, PowerPoint 2000, PowerPoint 2002, Office PowerPoint 2003, Office 
PowerPoint 2007, PowerPoint 2010, Excel 97, Excel 2000, Excel 2002, Office Excel 2003, Office 
Excel 2007, and Excel 2010 omit the morelnfo field when signing the VBA project. However, if the 
field is provided, the applications interpret it. 

<16> Section 2. 3. 2. 5.3: Word 97, Word 2000, Word 2002, Office Word 2003, Office Word 
Word 2010, PowerPoint 97, PowerPoint 2000, PowerPoint 2002, Office PowerPoint 2003, Office 
PowerPoint 2007, PowerPoint 2010, Excel 97, Excel 2000, Excel 2002, Office Excel 2003, Office 
Excel 2007, and Excel 2010 write properties in the digital certificate store as a byproduct of the way 
the digital certificate store is constructed, but none of the properties specify any behavior and are 
ignored when encountered. 

<17> Section 2.3.3: A minimal document is not required to contain this property set storage, but all 
files written through a standard save operation by Word 97, Word 2000, Word 2002, Office Word 
2003, Office Word 2007, Word 2010, PowerPoint 97, PowerPoint 2000, PowerPoint 2002, Office 
PowerPoint 2003, Office PowerPoint 2007, PowerPoint 2010, Excel 97, Excel 2000, Excel 2002, 

Office Excel 2003, Office Excel 2007, and Excel 2010 include this property set storage. 

<18> Section 2.3.3.1.4: Word 97, Word 2000, Word 2002, Office Word 2003, Office Word 2007, 
Word 2010, PowerPoint 97, PowerPoint 2000, PowerPoint 2002, Office PowerPoint 2003, Office 
PowerPoint 2007, PowerPoint 2010, Excel 97, Excel 2000, Excel 2002, Office Excel 2003, Office 
Excel 2007, and Excel 2010 do not constrain this value on write, but enforce this constraint on read. 

<19> Section 2.3.3.1.4: Word 97, Word 2000, Word 2002, Office Word 2003, Office Word 2007, 
Word 2010, PowerPoint 97, PowerPoint 2000, PowerPoint 2002, Office PowerPoint 2003, Office 
PowerPoint 2007, PowerPoint 2010, Excel 97, Excel 2000, Excel 2002, Office Excel 2003, Office 
Excel 2007, and Excel 2010 write out the count of bytes including padding and the null-terminating 
character. 

<20> Section 2. 3. 3. 1.4: T he rMS-OLEPSI specification requires that padding is done with 0x00 
values, but Word 97, Word 2000, Word 2002, Office Word 2003, Office Word 2007, Word 2010, 
PowerPoint 97, PowerPoint 2000, PowerPoint 2002, Office PowerPoint 2003, Office PowerPoint 2007, 
PowerPoint 2010, Excel 97, Excel 2000, Excel 2002, Office Excel 2003, Office Excel 2007, and Excel 
2010 write out arbitrary values for their padding in this case. 

<21> Section 2. 3. 3. 1.5: Word 97, Word 2000, Word 2002, Office Word 2003, Office Word 2007, 
Word 2010, PowerPoint 97, PowerPoint 2000, PowerPoint 2002, Office PowerPoint 2003, Office 
PowerPoint 2007, PowerPoint 2010/Excel 97, Excel 2000, Excel 2002, Office Excel 2003, Office 
Excel 2007, and Excel 2010 do not constrain this value on write, but enforce this constraint on read. 

<22> Section 2. 3. 3. 1.6: Word 97, Word 2000, Word 2002, Office Word 2003, Office Word 2007, 
Word 2010, PowerPoint 97, PowerPoint 2000, PowerPoint 2002, Office PowerPoint 2003, Office 
PowerPoint 2007, PowerPoint 2010, Excel 97, Excel 2000, Excel 2002, Office Excel 2003, Office 
Excel 2007, and Excel 2010 do not constrain this value on write, but enforce this constraint on read. 

<23> Section 2.3. 3. 1.6: T he rMS-OLEPSI specification requires that padding is done with 0x00 
values, but Word 97, Word 2000, Word 2002, Office Word 2003, Office Word 2007, Word 2010, 
PowerPoint 97, PowerPoint 2000, PowerPoint 2002, Office PowerPoint 2003, Office PowerPoint 2007, 
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PowerPoint 2010, Excel 97, Excel 2000, Excel 2002, Office Excel 2003, Office Excel 2007, and Excel 
2010 write out arbitrary values for their padding in this case. 


<24> Section 2.3.3.1.18: For PowerPoint 97, PowerPoint 2000, PowerPoint 2002, Office PowerPoint 
2003, Office PowerPoint 2007, and PowerPoint 2010 document content, other than hyperlinks on 
shapes, the value is 0x00000007. 

<25> Section 2.3.3.1.18: Word 97, Word 2000, Word 2002, Office Word 2003, Office Word 2007 
and Word 2010 generate this value as specified in MS DOC section 2.4.7. Excel 97, Excel 2000, 
Excel 2002, Office Excel 2003, Office Excel 2007 and Excel 2010 generate this value as specified in 
rMS-XLSl section 2.7.1. For PowerPoint 97, PowerPoint 2000, PowerPoint 2002, Office PowerPoint 
2003, Office PowerPoint 2007 and PowerPoint 2010, the value is 0x00000006. 

<26> Section 2.3.3.1.18: For hyperlinks on shapes, this value is generated as specifiedi'tft' TMS- 
ODRAW1 section 2.5.1. For hyperlinks in other Word 97, Word 2000, Word 2002, Office Word 2003, 
Office Word 2007 and Word 2010 document content, this value is 0x00000005. For hyperlinks in 
other Excel 97, Excel 2000, Excel 2002, Office Excel 2003, Office Excel 2007 and Excel 2010 
document content, this value is 0x00000006. For hyperlinks in other PowerPoint 97, PowerPoint 
2000, PowerPoint 2002, Office PowerPoint 2003, Office PowerPoint 2007 and PowerPoint 2010 
document content, this value is 0x0000007. 

<27> Section 2.3.3.1.18: T he unsigned 2-byte integer specified by the high two bytes of this value 
can always be written as 0x0000 by an application that saves the entire file, as it specifies that the 
hyperlink is in sync with the document contents. If a process changes the hyperlink property 
element without a corresponding change to the related document content such that the hyperlink 
needs to be fixed in the document the next time the document is loaded, this value needs to be 
changed to 0x0001 by the process. If such a process wishes to specify that the hyperlink is to be 
removed from the document the next time the document is loaded, this value needs to be changed 
to 0x0002 by the process. 

<28> Section 2.3.3.2.1.1: The GKPIDSI_PAGECOUNT property is written and interpreted by Word 
97, Word 2000, Word 2002, Office Word 2003, Office Word 2007, and Word 2010 only. PowerPoint 
97, PowerPoint 2000, PowerPoint 2002, Office PowerPoint 2003, Office PowerPoint 2007, PowerPoint 
2010, Excel 97, Excel 2000, Excel 2002, Office Excel 2003, Office Excel 2007, and Excel 2010 omit 
the property, or preserve an existing value but ignore it. 

<29> Section 2. 3. 3. 2. 1.1: In some cases Word 97, Word 2000, Word 2002, Office Word 2003, 

Office Word 2007, and Word 2010 write an estimate for this value. PowerPoint 97, PowerPoint 2000, 
PowerPoint 2002, Office PowerPoint 2003, Office PowerPoint 2007, and PowerPoint 2010 will 
calculate an accurate value for this property on each save. 

<30> Section 2. 3. 3. 2. 1.1: The GKPIDSI_WORDCOUNT property is written and interpreted by 
Word 97, Word 2000, Word 2002, Office Word 2003, Office Word 2007, Word 2010, PowerPoint 97, 
PowerPoint 2000, PowerPoint 2002, Office PowerPoint 2003, Office PowerPoint 2007, and PowerPoint 
2010. Excel 97, Excel 2000, Excel 2002, Office Excel 2003, Office Excel 2007, and Excel 2010 omit 
the property, or preserve an existing value but ignore it. 

The GKPIDSI_CHARCOUNT property is written and interpreted by 
Word 97, Word 2000, Word 2002, Office Word 2003, Office Word 2007, and Word 2010 only. 
PowerPoint 97, PowerPoint 2000, PowerPoint 2002, Office PowerPoint 2003, Office PowerPoint 2007, 
PowerPoint 2010, Excel 97, Excel 2000, Excel 2002, Office Excel 2003, Office Excel 2007, and Excel 
2010 omit the property, or preserve an existing value but ignore it. 

<32> Section 2. 3. 3. 2. 2.1: The GKPIDDSI_PRESFORMAT property is written and interpreted by 
PowerPoint 97, PowerPoint 2000, PowerPoint 2002, Office PowerPoint 2003, Office PowerPoint 2007, 
and PowerPoint 2010 only. Word 97, Word 2000, Word 2002, Office Word 2003, Office Word 2007, 


193 / 205 

[MS-OSHARED] - V20120122 
Office Common Data Types and Objects Structures 

Copyright © 2012 Microsoft Corporation. 

Release: Sunday, January 22, 2012 


Word 2010, Excel 97, Excel 2000, Excel 2002, Office Excel 2003, Office Excel 2007, and Excel 2010 
omit the property, write an empty string for the value, or preserve a read value from an existing file 
but ignore it. 

<33> Section 2. 3. 3. 2. 2.1: Only written by PowerPoint 97, PowerPoint 2000, PowerPoint 2002, and 
Office PowerPoint 2003. 

<34> Section 2.3.3.2.2.1: Only written by Office PowerPoint 2007 and PowerPoint 2010. 

<35> Section 2.3. 3. 2.2.1: Only written by Office PowerPoint 2007 and PowerPoint 2010. 

<36> Section 2.3.3.2.2.1: Only written by Office PowerPoint 2007 and PowerPoint 2010. 

<37> Section 2. 3. 3. 2. 2.1: The GKPIDDSI_BYTECOUNT property is written by Word 97, Wor 

2000, Word 2002, Office Word 2003, Office Word 2007, Word 2010, PowerPoint 97, PowerPoint 
2000, PowerPoint 2002, Office PowerPoint 2003, Office PowerPoint 2007, and PowerPoint 2010 only. 
Excel 97, Excel 2000, Excel 2002, Office Excel 2003, Office Excel 2007, and Excel 2010 omit the 
property, or preserve an existing value but ignore it. Word 97, Word 2000, Word 2002, Office Word 
2003, Office Word 2007, and Word 2010 usually omit this property or in some scenarios write a 
value that is inaccurate for this property, because Word 97, Word 2000, Word 2002, Office Word 
2003, Office Word 2007, and Word 2010 only set or update this property when the 
BuiltlnDocumentProperties property is called from the application's document object model and 
do not recalculate it on save. 

<38> Section 2.3.3.2.2.1: T he GKPIDDSI_LINECOUNT property is written and interpreted by 
Word 97, Word 2000, Word 2002, Office Word 2003, Office Word 2007, and Word 2010 only. 
PowerPoint 97, PowerPoint 2000, PowerPoint 2002, Office PowerPoint 2003, Office PowerPoint 2007, 
PowerPoint 2010, Excel 97, Excel 2000, Excel 2002, Office Excel 2003, Office Excel 2007, and Excel 
2010 omit the property, or preserve an existing value but ignore it. 

<39> Section 2. 3. 3. 2. 2.1: In some cases Word 97, Word 2000, Word 2002, Office Word 2003, 

Office Word 2007, and Word 2010 write an estimate for this value. PowerPoint 97, PowerPoint 2000, 
PowerPoint 2002, Office PowerPoint 2003, Office PowerPoint 2007, and PowerPoint 2010 will 
calculate an accurate value for this property on each save. 

<40> Section 2. 3. 3. 2. 2.1: The GKPIDDSI_PARACOUNT property is written and interpreted by 
Word 97, Word 2000, Word 2002, Office Word 2003, Office Word 2007, Word 2010, PowerPoint 97, 
PowerPoint 2000, PowerPoint 2002, Office PowerPoint 2003, Office PowerPoint 2007 and PowerPoint 
2010. Excel 97, Excel 2000, Excel 2002, Office Excel 2003, Office Excel 2007, and Excel 2010 omit 
the property, or preserve an existing value but ignore it. 

<41> Section 2. 3. 3. 2. 2.1: The GKPIDDSI_SLIDECOUNT property is written and interpreted by 
PowerPoint 97, PowerPoint 2000, PowerPoint 2002, Office PowerPoint 2003, Office PowerPoint 2007, 
and PowerPoint 2010 only. Word 97, Word 2000, Word 2002, Office Word 2003, Office Word 2007, 
Word 2010, Excel 97, Excel 2000, Excel 2002, Office Excel 2003, Office Excel 2007, and Excel 2010 
omit the property, write 0, or preserve an existing value but ignore it. 

The GKPIDDSI_NOTECOUNT property is written and interpreted by 
PowerPoint 97, PowerPoint 2000, PowerPoint 2002, Office PowerPoint 2003, Office PowerPoint 2007, 
and PowerPoint 2010 only. Word 97, Word 2000, Word 2002, Office Word 2003, Office Word 2007, 
Word 2010, Excel 97, Excel 2000, Excel 2002, Office Excel 2003, Office Excel 2007, and Excel 2010 
omit the property, write 0, or preserve an existing value but ignore it. 

<43> Section 2. 3. 3. 2. 2.1: The GKPIDDSI_HIDDENCOUNT property is written and interpreted by 
PowerPoint 97, PowerPoint 2000, PowerPoint 2002, Office PowerPoint 2003, Office PowerPoint 2007, 
and PowerPoint 2010 only. Word 97, Word 2000, Word 2002, Office Word 2003, Office Word 2007, 
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Word 2010, Excel 97, Excel 2000, Excel 2002, Office Excel 2003, Office Excel 2007, and Excel 2010 
omit the property, write 0, or preserve an existing value but ignore it. 


<44 > Section 2. 3. 3. 2. 2.1: The GKPIDDSI_MMCLIPCOUNT property is written and interpreted by 
PowerPoint 97, PowerPoint 2000, PowerPoint 2002, Office PowerPoint 2003, Office PowerPoint 2007, 
and PowerPoint 2010 only. Word 97, Word 2000, Word 2002, Office Word 2003, Office Word 2007, 
Word 2010, Excel 97, Excel 2000, Excel 2002, Office Excel 2003, Office Excel 2007, and Excel 2010 
omit the property, write 0, or preserve an existing value but ignore it. 

<45> Section 2.3. 3. 2. 2.1: The GKPIDDSI_LINKSDIRTY property is interpreted by Word 97, Word 
2000, Word 2002, Office Word 2003, Office Word 2007, and Word 2010 only. PowerPoint 97, 
PowerPoint 2000, PowerPoint 2002, Office PowerPoint 2003, Office PowerPoint 2007, PowerPoint 
2010, Excel 97, Excel 2000, Excel 2002, Office Excel 2003, Office Excel 2007, and Excel 2010 write 
0x00000000 for the property value. Excel 97, Excel 2000, Excel 2002, Office Excel 2003, Office 
Excel 2007 and Excel 2010 will preserve an existing value but ignore it (though in the value 
preservation case, a nonzero value will get converted to the value OxFFFFFFF on save). PowerPoint 
97, PowerPoint 2000, PowerPoint 2002, Office PowerPoint 2003, Office PowerPoint 2007, PowerPoint 
2010, Excel 97, Excel 2000, Excel 2002, Office Excel 2003, Office Excel 2007, and Excel 2010 
always fix up linked fields regardless of the state of this property. Word 97, Word 2000, Word 2002, 
Office Word 2003, Office Word 2007, and Word 2010 always write the G KPI DDSI_LI N KSD1 RTY 
property as FALSE (0x00000000) because they write out updated linked property values, if 
applicable, in the User Defined Property Set (section 2. 3. 3. 2. 3 ) when saving a document. 

<46> Section 2. 3. 3. 2. 2.1: The GKPIDDSI_CCHWITHSPACES property is written and interpreted 
by Word 97, Word 2000, Word 2002, Office Word 2003, Office Word 2007, and Word 2010 only. 
PowerPoint 97, PowerPoint 2000, PowerPoint 2002, Office PowerPoint 2003, Office PowerPoint 2007, 
PowerPoint 2010, Excel 97, Excel 2000, Excel 2002, Office Excel 2003, Office Excel 2007, and Excel 
2010 omit the property, or will preserve an existing value but ignore it. 

<47> Section 2.3.3.2.2.1: Word 97, Word 2000, Word 2002, Office Word 2003, Office Word 2007, 
Word 2010, PowerPoint 97, PowerPoint 2000, PowerPoint 2002, Office PowerPoint 2003, Office 
PowerPoint 2007, PowerPoint 2010, Excel 97, Excel 2000, Excel 2002, Office Excel 2003, Office 
Excel 2007, and Excel 2010 always write the GKPIDDSI_HYPERLINKSCHANGED property as 
FALSE because the applications write out an updated "_PID_HLINKS" property, if applicable, in 
the User Defined Property Set (section 2. 3. 3. 2. 3 ) when saving a document. 

<48> Section 2. 3. 3. 2.2.1: Word 97, Word 2000, Word 2002, Office Word 2003, PowerPoint 97, 
PowerPoint 2000, PowerPoint 2002, Office PowerPoint 2003, Excel 97, Excel 2000, Excel 2002, and 
Office Excel 2003 write their respective application minor version numbers as the minor version 
number portion of the GKPIDDSI_VERSION property. 

<49> Section 2. 3. 3. 2. 2.1: PowerPoint 2000, PowerPoint 2002, Office PowerPoint 2003, Office 
PowerPoint 2007, PowerPoint 2010, Excel 2000, Excel 2002, Office Excel 2003, Office Excel 2007, 
and Excel 2010 use this property for storing their VBA digital signature. Word 2000, Word 2002, 
Office Word 2003, Office Word 2007, and Word 2010 store their VBA digital signature in an 
unrelated location and will not write this property. Word 97, PowerPoint 97, and Excel 97 do not 
write digital signatures for VBA. 

<50> Section 2. 3. 3. 2.2.1: Word 97, Word 2000, Word 2002, Office Word 2003, PowerPoint 97, 
PowerPoint 2000, PowerPoint 2002, Office PowerPoint 2003, Excel 97, Excel 2000, Excel 2002, and 
Office Excel 2003 do not write this property, but preserve an existing value if it already exists. Office 
Word 2007^#&rd 2010, Office PowerPoint 2007, PowerPoint 2010, Office Excel 2007, and Excel 
2010 will write this property if opening a file from or saving a file to a Windows SharePoint Services 
document library, in which case they will write the value "document". 
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<51> Section 2. 3. 3. 2.2.1: Word 97, Word 2000, Word 2002, Office Word 2003, PowerPoint 97, 
PowerPoint 2000, PowerPoint 2002, Office PowerPoint 2003, Excel 97, Excel 2000, Excel 2002, and 
Office Excel 2003 do not write this property, but preserve an existing value if it already exists. 


<52> Section 2. 3. 3. 2. 2.1: Word 97, Word 2000, Word 2002, Office Word 2003, Office Word 2007, 
Word 2010, PowerPoint 97, PowerPoint 2000, PowerPoint 2002, Office PowerPoint 2003, Office 
PowerPoint 2007, PowerPoint 2010, Excel 97, Excel 2000, Excel 2002, Office Excel 2003, Office 
Excel 2007, and Excel 2010 do not write this property, but preserve an existing value if it already 
exists. 

<53> Section 2.3.3.2.2.1: Word 97, Word 2000, Word 2002, Office Word 2003, Office Word 2007, 
Word 2010, PowerPoint 97, PowerPoint 2000, PowerPoint 2002, Office PowerPoint 2003, Office 
PowerPoint 2007, PowerPoint 2010, Excel 97, Excel 2000, Excel 2002, Office Excel 2003, Office 
Excel 2007, and Excel 2010 do not write this property, but preserve an existing value if it already 
exists. 

<54> Section 2.3.3.2.3.2: Excel 97 and Word 97 write a random GUID for the _PID_GUID 
property if the property does not yet exist. PowerPoint 97 writes a random GUID for this property on 
document creation only. 

<55> Section 2.3.3.2.3.2: The _MarkAsFinal property applies only to Office Excel 2007, Excel 
2010, Office Word 2007, Word 2010, Office PowerPoint 2007, and PowerPoint 2010. Other 
applications do not write this property and ignore it on read, but preserve an existing value. 

<56> Section 2.3.3.2.3.2: The Microsoft Theme property applies only to Word 97, Word 2000, 
Word 2002, Office Word 2003, Office Word 2007, and Word 2010. Other applications do not write 
this property and ignore it on read, but preserve an existing value. 

<57> Section 2.3.3.2.3.2: The Presentation property applies only to Office PowerPoint 2007 and 
PowerPoint 2010. Other applications do not write this value and ignore ft on read, but preserve an 
existing value. 

<58> Section 2.3. 3. 2. 3.2: The SlideDescription property applies only to Office PowerPoint 2007 
and PowerPoint 2010. Other applications do not write this value and ignore it on read, but preserve 
an existing value. 

<59> Section 2. 3. 3. 2. 3. 2: The _AllowSignedDocumentWithoutReadOnly property applies only 
to Office Excel 2007, Excel 2010, Office Word 2007, Word 2010, Office PowerPoint 2007, and 
PowerPoint 2010. Previous versions of the applications ignore this property, but preserve an existing 
value. 


<60> Section 2. 3. 3. 2. 3. 2: The __TemplateID property applies only to Office Word 2003, Office 
PowerPoint 2003, Office Excel 2003, Office Word 2007, Office PowerPoint 2007, Office Excel 2007, 
Word 2010, PowerPoint 2010, and Excel 2010. Previous versions of the applications ignore this 
property but preserve ^existing value. 

<61> Section 2.3. 3.2.3. 2: Unless otherwise specified, these properties apply only to Office Word 
2003, Office PowerPoint 2003, Office Excel 2003, Office Word 2007, Office PowerPoint 2007, Office 
Excel 2007, Word 2010, PowerPoint 2010, and Excel 2010. Previous versions of the applications do 
jiot write these values and ignore them on read, but will preserve an existing value. 

<62> Section 2. 3. 3. 2. 3. 2: The _CheckOutSrcllrl property applies only to Office Word 2007, Office 
PowerPoint 2007, Office Excel 2007, Word 2010, PowerPoint 2010, and Excel 2010. Previous 
versions of the applications do not write this value and ignore it on read, but will preserve an 
existing value. 
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<63> Section 2.3. 3. 2.3. 2: Regardless of case, "none" is considered an invalid identifier for a smart 
document solution by Office Word 2003, Office Word 2007, Word 2010, Office Excel 2003, Office 
Excel 2007, and Excel 2010. 


<64> Section 2. 3. 3. 2. 3. 2: Office Word 2003, Office Word 2007, Word 2010, Office Excel 2003, 
Office Excel 2007, and Excel 2010 read and write this property. Other applications do not write this 
value and ignore it on read, but will preserve an existing value. 

<65> Section 2. 3. 3. 2. 3. 2: Office Word 2003, Office Word 2007, Word 2010, Office Excel 2003, 
Office Excel 2007, and Excel 2010 read and write this property. Other applications do not write this 
value and ignore it on read, but will preserve an existing value. 

<66> Section 2.3. 3. 2. 3. 2: Office Word 2003, Office Word 2007, and Word 2010 read and write this 
property. Other applications do not write this value and ignore it on read, but will preserve an 
existing value. 

<67> Section 2.3.3.2.3.2: Regardless of case, "none" is considered an invalid identifier for a 
solution by Office Word 2003, Office Word 2007, and Word 2010. 

<68> Section 2.3.3.2.3.2: Office Word 2003, Office Word 2007, and Word 2010 read and write this 
property. Other applications do not write this value and ignore it on readout will preserve an 
existing value. 

<69> Section 2. 3. 3. 2.3. 2: For Office Word 2003, Office Excel 2003, Office Word 2007, Office Excel 
2007, Word 2010, and Excel 2010 documents, these solutions are generated through Visual Studio 
Tools for Office document add-in solutions. Managed code document add-in solutions are not 
supported by other applications or versions. 

<70> Section 2.3.3.2.3.2: Office Word 2003, Office Excel 2003, Office Word 2007, Office Excel 
2007, Word 2010, and Excel 2010 interpret this property and support managed code document add- 
in solutions. Other applications ignore the property on read, but will preserve an existing value. 

<71> Section 2. 3. 3. 2. 3. 2: Office Word 2003, Office Excel 2003, Office Word 2007, Office Excel 
2007, Word 2010, and Excel 2010 interpret this property and support managed code document add- 
in solutions. Other applications ignore the property on read, but will preserve an existing value. 

<72> Section 2. 3. 3. 2. 3. 2: Unless otherwise specified, these properties apply only to Word 2002, 
PowerPoint 2002, Excel 2002, Office Word 2003, Office PowerPoint 2003, Office Excel 2003, Office 
Word 2007, Office PowerPoint 2007, Office Excel 2007, Word 2010, PowerPoint 2010, and Excel 
2010. Previous versions of the applications do not write these values and ignore them on read, but 
will preserve an existing value. 

<73> Section 2. 3. 3. 2. 3. 2: Office Word 2003, Office PowerPoint 2003, Office Excel 2003, Office 
Word 2007, Offi ce^l^^^ g pi nt 2007, Office Excel 2007, Word 2010, PowerPoint 2010, and Excel 
2010 read and write this property. Previous versions of the applications do not write this value and 
ignore it on read, but will preserve an existing value. 

<74> Section 2. 3.3. 2. 3. 2: Office Word 2003, Office PowerPoint 2003, Office Excel 2003, Office 
Word 2007, Office PowerPoint 2007, Office Excel 2007, Word 2010, PowerPoint 2010, and Excel 
2010 ignore this property unless the registry key 

HKEY_CURRENT_USER\Software\Microsoft\Office\<vers/on>\Outlook\Options\Mail has 

a DWORD value named "AdHocReviewBehavior" with a value of 0, where <version> is "11.0" for 
Office Word 2003, Office PowerPoint 2003, and Office Excel 2003, "12.0" for Office Word 2007, 

Office PowerPoint 2007, and Office Excel 2007, or "14.0" for Word 2010, PowerPoint 2010, and 
Excel 2010. 
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<75> Section 2. 3. 3. 2.3. 3: Word 97, Word 2000, Word 2002, Office Word 2003, Office Word 2007, 
and Word 2010 create links to bookmarks for their linked properties, where the link entry's value is 
the name of the bookmark. Excel 97, Excel 2000, Excel 2002, Office Excel 2003, Office Excel 2007, 
and Excel 2010 create links to named ranges for their linked properties, where the link entry's value 
is the name of the range. PowerPoint 97, PowerPoint 2000, PowerPoint 2002, Office PowerPoint 
2003, Office PowerPoint 2007, and PowerPoint 2010 create links to bookmark portions of slide 
content for their linked properties, where the link entry's value is the identifier of the bookmarked 
slide content. 

<76> Section 2.3.6: Word 97, Word 2000, Word 2002, Office Word 2003, PowerPoint 97, 
PowerPoint 2000, PowerPoint 2002, Office PowerPoint 2003, Excel 97, Excel 2000, Excel 2002, and 
Office Excel 2003 do not create this storage. 

<77> Section 2.3.6. 1.4: Custom XML data item with the target namespace 
http://schemas.microsoft.com/office/2006/coverPageProps is only written by Office Word 2007 and 
Word 2010. 

<78> Section 2.3. 7. 7: The value 1 can also be saved. This will cause a return value of 
E_INVALI DARG from CreateUri(). 

<79> Section 2.3.7.7: T he value 1 can also be saved. This will cause a return value of 
E_INVALI DARG from CreateUriQ. 


<80> Section 4.3: If the digest data of the digital signature is not MD5 encoded, the signature will 
not be verified by existing versions of Word 97, Word 2000, Word 2002, Office Word 2003, Office 
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6 Change Tracking 


This section identifies changes that were made to the [MS-OSHARED] protocol document between 
the June 2011 and January 2012 releases. Changes are classified as New, Major, Minor, Editorial, or 
No change. 

The revision class New means that a new document is being released. 

The revision class Major means that the technical content in the document was significantly revised. 
Major changes affect protocol interoperability or implementation. Examples of major changes are: 

■ A document revision that incorporates changes to interoperability requirements or functionality. 

■ An extensive rewrite, addition, or deletion of major portions of content. 

■ The removal of a document from the documentation set. 

■ Changes made for template compliance. 

The revision class Minor means that the meaning of the technical content was clarified. Minor 
changes do not affect protocol interoperability or implementation. Examples of minor changes are 
updates to clarify ambiguity at the sentence, paragraph, or table level. 

The revision class Editorial means that the language and formatting in the technical content was 
changed. Editorial changes apply to grammatical, formatting, and style issues. 

The revision class No change means that no new technical or language changes were introduced. 
The technical content of the document is identical to the last released version, but minor editorial 
and formatting changes, as well as updates to the header and footer information, and to the revision 
summary, may have been made. 

Major and minor changes can be described further using the following change types: 

■ New content added. 

■ Content updated. 


New product behavior note added. 
Product behavior note updated. 


Product behavior note removed. 
New protocol #yntax^?fed. 


Protocol syntax updated. 
Protocol syntax removed. 


New content added due to protocol revision. 
Content updated due to protocol revision. 


Content removed due to protocol revision. 

New protocol syntax added due to protocol revision. 
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■ Protocol syntax updated due to protocol revision. 

■ Protocol syntax removed due to protocol revision. 

■ New content added for template compliance. 

■ Content updated for template compliance. 

■ Content removed for template compliance. 

■ Obsolete document removed. 

Editorial changes are always classified with the change type Editorially updated. 

Some important terms used in the change type descriptions are defined as follows: 

■ Protocol syntax refers to data elements (such as packets, structures, enumerations, and 
methods) as well as interfaces. 

■ Protocol revision refers to changes made to a protocol that affect the bits that are sent over 
the wire. 


The changes made to this document are listed in the following table. For more information, please 
contact protocol@microsoft.com . 


Section 

| ^ 
Tracking number (if applicable) 

and description 

Sr 

N) 

Change type 

2.1 

Common ABNF 

Definitions 

Clarified reference for ABNF definitions. 

N 

Content 

updated. 

2. 3. 3. 1.5 

UnalianedLDStr 

Added the product behavior note for the "cch" field. 

N 

New product 
behavior 
note added. 

2. 3. 3. 1.6 

Lpwstr 

Updated the product behavior note for the "padding" 
field. 

N 

Product 

behavior 

note 

updated. 

2. 3. 3.2. 2.1 

PIDDSI 

Added the product behavior notes for 
GKPIDDSI_PRESFORMAT values "On-screen Show 
|||4:3)" and "On-screen Show (16:9)" 

N 

New product 
behavior 
note added. 

2. 3. 3. 2. 2.1 

PIDDSI 

Revised the product behavior note for 

GKPIDDSI BYTECOUNT. 

N 

Product 

behavior 

note 

updated. 

Reserved Properties 

Clarified, for reserved name _TemplateID, the 
reference for ABNF and <DIGIT>. Clarified, for 
reserved name _SharedFileIndex, the reference for 
ABNF. 

N 

Content 

updated. 

jP^3.3.2.3.2 
^Reserved Properties 

Added the product behavior note for reserved 
names Solution ID and Other Solution Id where the 
text reads "MAY be ignored". 

N 

New product 
behavior 
note added. 
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Section 

Tracking number (if applicable) 
and description 

Major 
change 
(Y or 

N) 

Change type 

2. 3. 3.2. 3. 2 

Reserved Properties 

Updated the product behavior notes for reserved 
name Solution Template ID and where the text 
reads "properties associated with managed code 
document add-in solutions". 

N 

Product 

behavior 

note 

updated. 

2.3. 4.3 

ProDertvBaa 

Clarified the description of "id". 

N 

Content 

updated. 

2.3. 4.4 

Property 

Clarified the reference for PropertyBagStore. 

N 

Content 

updated. 

3.2,2 

Document Summary 

Information Property 

Set Overview 

Clarified the reference for "Document Summary 
Information property set". 

N 

Content 

updated. 

5 

Appendix A: Product 

Behavior 

Updated the list of product versions. 

Pn a 

Content 

updated. 
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